如何通过Python将字典对象高效序列化并保存为JSON文件？-Python教程-PHP中文网

json.dump()直接写入文件，省去字符串中间转换，更省内存且高效；支持ensure_ascii=False保留中文、indent格式化，并通过default参数处理datetime等非标类型。

如何通过python将字典对象高效序列化并保存为json文件？

为什么直接用 `json.dump()` 就够用了

绝大多数场景下，不需要额外封装或引入第三方库。json.dump() 本身已针对文件写入做了缓冲和编码优化，比先调 json.dumps() 再写文件更省内存、更少字符串拼接开销。

直接写入避免了中间生成完整 JSON 字符串——对大字典（比如含上万条记录的 data）尤其关键
支持 ensure_ascii=False 保留中文，indent=2 格式化（仅调试用，生产环境建议关掉）
注意：default 参数必须是可调用对象，用于处理非标准类型（如 datetime、set），否则会报 TypeError: Object of type ... is not JSON serializable

遇到 datetime 或自定义对象怎么办

Python 的 dict 里混了 datetime、Decimal、UUID 或你自己写的类实例？json.dump() 默认不认它们。

最简方案：用 default 参数接管序列化逻辑，例如：

def json_default(obj):
    if isinstance(obj, datetime.datetime):
        return obj.isoformat()
    elif isinstance(obj, Decimal):
        return float(obj)
    raise TypeError(f"Object of type {type(obj)} is not JSON serializable")

别写成 lambda obj: obj.isoformat() if hasattr(obj, 'isoformat') else str(obj) —— 这种“兜底转 str”看似省事，但可能把错误悄悄掩盖（比如把 bytes 转成乱码字符串）
如果项目中多次用到，建议封装一个复用的 JSONEncoder 子类，而不是每次传 default

保存时文件被截断或乱码怎么排查

常见现象：文件打开后只有前半部分，或者中文显示为 \u4f60\u597d 或一堆问号。根本原因几乎都出在文件打开模式和编码上。

arcgis-js

提供 ArcGIS Maps SDK for JavaScript 开发辅助，涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。

下载

必须用 open(..., 'w', encoding='utf-8') —— 缺少 encoding 参数在 Windows 上极易出乱码；用 'wb' 模式会触发 TypeError: write() argument must be str, not bytes
不要手动调 f.write(json.dumps(...)) 后忘记 f.close()，推荐用 with open(...) as f: 确保异常时也能关闭
如果字典嵌套极深或含超长字符串，注意系统默认递归限制（RecursionError），可临时调高：sys.setrecursionlimit(10000)，但更应检查数据结构是否合理

需要原子写入或避免覆盖旧文件吗

线上服务里直接 json.dump(..., f) 覆盖原文件有风险：写到一半进程崩溃，就剩一个损坏的空文件。

用临时文件 + os.replace() 实现原子替换：

import json
import os
import tempfile

def safe_json_dump(data, filepath):
    with tempfile.NamedTemporaryFile(mode='w', encoding='utf-8', delete=False) as f:
        json.dump(data, f, ensure_ascii=False)
        temp_name = f.name
    os.replace(temp_name, filepath)

Windows 下 os.replace() 是原子的；Linux/macOS 也一样。别用 shutil.move()，它在跨文件系统时可能降级为复制+删除，不保证原子性
如果目标路径所在磁盘空间不足，tempfile.NamedTemporaryFile 仍可能失败，需捕获 OSError 并清理临时文件

实际用的时候，多数情况一行 json.dump(data, open('config.json', 'w', encoding='utf-8')) 就能跑通；但只要涉及时间、精度、并发写或生产部署，上面几个点漏掉任何一个，都可能让程序在某个凌晨三点静默坏掉。