Python写入JSON文件教程：json.dump中文不转义

用Python标准库json把dict/list写入JSON文件，解决中文被转义成\uXXXX的问题，支持缩进美化、原子写入，附完整代码。

场景痛点

把Python字典存成JSON给前端、给下游系统用，结果打开一看中文全变成 \u4f60\u597d，机器能读人看不懂；或者写一半程序崩了，文件只剩一半，下游解析直接挂。这篇讲清楚正确写JSON的姿势。

用到的库

# 纯标准库，无需pip安装

完整代码

# 用Python写入JSON文件
import json
import os
import tempfile

def write_json_pretty(file_path, data):
"""
美化格式写JSON：缩进2空格、中文不转义、按key排序。
适合给人看的配置文件、导出文件。
"""
with open(file_path, "w", encoding="utf-8") as f:
json.dump(
data,
f,
ensure_ascii=False,   # 关键：中文不转义成\uXXXX
indent=2,             # 缩进美化
sort_keys=True,       # key按字典序排序，便于diff
separators=(",", ": "),
)
print(f"美化写入完成：{file_path}")

def write_json_compact(file_path, data):
"""
紧凑格式写JSON：不缩进、无空格，体积小，适合传输存储。
"""
with open(file_path, "w", encoding="utf-8") as f:
json.dump(data, f, ensure_ascii=False, separators=(",", ":"))
size = os.path.getsize(file_path)
print(f"紧凑写入完成：{file_path}，{size} 字节")

def write_json_atomic(file_path, data):
"""
原子写入：先写到临时文件，写完再rename，避免写一半崩了留下坏文件。
重要数据建议用这种方式。
"""
dir_name = os.path.dirname(file_path) or "."
with tempfile.NamedTemporaryFile(
"w", encoding="utf-8", dir=dir_name, delete=False, suffix=".tmp"
) as tmp:
json.dump(data, tmp, ensure_ascii=False, indent=2)
tmp.flush()
os.fsync(tmp.fileno())  # 强制刷盘
os.replace(tmp.name, file_path)  # 原子替换
print(f"原子写入完成：{file_path}")

def main():
data = {
"name": "张三",
"age": 28,
"city": "北京",
"tags": ["技术", "Python", "数据"],
"is_vip": True,
"score": 95.5,
"extra": None,
}

write_json_pretty("config_pretty.json", data)
write_json_compact("config_compact.json", data)
write_json_atomic("config_atomic.json", data)

if __name__ == "__main__":
main()