Python怎么将字典数据快速保存为JSON文件_使用json.dump方法并处理中文编码-Python教程-PHP中文网

json.dump保存中文乱码需同时设置ensure_ascii=false和encoding="utf-8"；处理非标准类型需用default参数；避免尾部逗号和控制字符以确保跨平台兼容。

python怎么将字典数据快速保存为json文件_使用json.dump方法并处理中文编码

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-script-generator

快速生成专业的 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