json.dump()直接写入文件，省去字符串中间转换，更省内存且高效；支持ensure_ascii=False保留中文、indent格式化，并通过default参数处理datetime等非标类型。
为什么直接用 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 或一堆问号。根本原因几乎都出在文件打开模式和编码上。
- 必须用
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) 覆盖原文件有风险：写到一半进程崩溃，就剩一个损坏的空文件。
立即学习“Python免费学习笔记（深入）”；
- 用临时文件 +
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')) 就能跑通；但只要涉及时间、精度、并发写或生产部署，上面几个点漏掉任何一个，都可能让程序在某个凌晨三点静默坏掉。 
