json.dump保存中文乱码需同时设置ensure_ascii=False和encoding="utf-8"；处理非标准类型需用default参数；避免尾部逗号和控制字符以确保跨平台兼容。
json.dump 保存字典时中文变乱码？关键是 ensure_ascii=False
默认情况下 json.dump 会把非 ASCII 字符（比如中文）转成 Unicode 转义序列，如 "\u4f60\u597d"，而不是直接写入 UTF-8 字符。这不是 bug，是设计行为——但多数人要的是可读的中文文件。
解决方法很简单：显式传入 ensure_ascii=False，并确保文件以 UTF-8 打开：
import json
data = {"name": "张三", "city": "上海"}
with open("output.json", "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, indent=2)
-
encoding="utf-8"必须和ensure_ascii=False配合使用，缺一不可 -
indent=2不是必须的，但加了更易读；不加则输出为单行 - 如果漏掉
encoding="utf-8"，在 Windows 上可能报UnicodeEncodeError
用 json.dump 还是 json.dumps + write？性能和内存怎么选
两种写法都能实现，但适用场景不同：
- 直接用
json.dump(data, f, ...)：数据一次性写入文件，内存占用低，适合大字典（比如上万条记录） - 先
json.dumps(data, ...)得到字符串，再f.write(...)：方便中间处理（如拼接前缀、加注释），但会把整个 JSON 字符串加载进内存，字典大时容易 OOM
除非有特殊需求，优先用 json.dump。注意不要混用：json.dump 接文件对象，json.dumps 返回字符串——类型错会导致 TypeError: expected str, bytes or os.PathLike object。
立即学习“Python免费学习笔记（深入）”；
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
字典含 datetime、set 或自定义对象时 json.dump 直接报错
json.dump 只认基本类型（dict、list、str、int、float、bool、None）。遇到 datetime、set、bytes 或自定义类实例，会抛 TypeError: Object of type ... is not JSON serializable。
解决方式是提供 default 参数：
import json
from datetime import datetime
data = {"ts": datetime.now(), "tags": {"python", "json"}}
def json_fallback(obj):
if isinstance(obj, datetime):
return obj.isoformat()
elif isinstance(obj, set):
return list(obj)
raise TypeError(f"Object of type {type(obj).__name__} is not JSON serializable")
with open("output.json", "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, default=json_fallback)
- 别用
str(obj)当 fallback——虽然不报错，但语义丢失严重（比如datetime变成"2024-05-12 14:23:00.123456"，无法被标准 JSON 解析器还原） - 如果项目中多次用到，建议封装一个复用的
default函数，或继承json.JSONEncoder
保存后用其他程序读不了？检查换行符和尾部逗号
JSON 标准不支持尾部逗号（trailing comma）和控制字符（如 \x00），但 Python 的 json 模块默认允许写入（尤其在 indent 模式下）。某些严格解析器（如前端 JSON.parse、部分嵌入式 JSON 库）会因此失败。
- 避免手动在字典里写
"key": "value",——Python 允许，JSON 不允许 - 不用
indent时，json.dump不会加多余空白；但用了indent后，确保目标环境支持带缩进的 JSON（绝大多数现代工具都支持） - 如果文件用于跨平台传输，确认换行符是
\n（Unix 风格）；Windows 下用open(..., newline="")防止额外插入\r
最稳妥的做法：保存后用 json.load(open("output.json")) 在 Python 里反向验证一次，能成功加载就基本兼容。
