Python怎么写入JSON文件_json.dump()中文字符与格式化

陌辰小哥_7069

陌辰小哥_7069

2026-03-18

554人浏览

原创

json.dump()写入中文需设ensure_ascii=False,否则中文被转义为\uXXXX;文件打开必须用encoding="utf-8",indent和sort_keys仅影响可读性。

python怎么写入json文件_json.dump()中文字符与格式化

json.dump()写入中文变乱码?关键是ensure_ascii=False

默认情况下json.dump()会把非ASCII字符(比如中文)转成\uXXXX形式,不是真乱码,是刻意转义。想原样保留中文,必须显式传ensure_ascii=False。

常见错误现象:{"name": "\u4f60\u597d"}这种输出,看着像乱码,其实是JSON标准行为。

  • 不加ensure_ascii=False,中文一定被转义,无论文件编码设成utf-8还是其他
  • 即使文件用encoding="utf-8"打开,没关ensure_ascii也没用
  • Python 3.7+ 默认文件写入是utf-8,但json.dump()不买账,它只认自己的参数

正确写法示例:

import json
data = {"name": "张三", "city": "上海"}
with open("output.json", "w", encoding="utf-8") as f:
    json.dump(data, f, ensure_ascii=False, indent=2)

格式化输出靠indent和sort_keys,但别滥用indent

indent控制缩进空格数,sort_keys=True让键按字母序排列——这两个参数只影响可读性,不影响JSON合法性。

使用场景:调试、配置文件、人工查看的导出数据;不适合日志或API响应体这类对体积敏感的场景。

  • indent=2最常用,indent=None(默认)生成紧凑单行
  • sort_keys=True能避免因字典插入顺序不同导致diff误报,适合做版本控制的配置文件
  • 加indent会让文件体积显著增大,10KB原始数据可能变成30KB+,线上服务慎用

文件打开模式必须用"w"且指定encoding="utf-8"

Python 3里字符串是Unicode,但文件操作最终要落盘为字节。如果打开文件时不声明encoding,Windows下可能用cp1252,Linux/macOS可能用locale默认编码,都会导致中文写入失败或错乱。

Python Pep Authoring
Python Pep Authoring

依据官方 python/peps仓库规则起草、审阅、编辑或准备 Python 改进提案(PEP),用于处理 PEP 文本和元数据头部。

下载
  • 必须用open(..., "w", encoding="utf-8"),不能只写"w"
  • 不能用"wb"模式配json.dump()——后者写的是字符串,不是bytes
  • 如果用json.dumps()先生成字符串再写入,也要确保open()带encoding="utf-8"

错误示范:open("x.json", "w") —— 在中文Windows上大概率报UnicodeEncodeError。

dump()和dumps()选哪个?看你要不要直接写文件

json.dump()直接写文件对象,json.dumps()返回字符串。两者参数一致,但调用方式不同。

容易踩的坑:想用dumps()结果再手动f.write(),却忘了加encoding或用了"wb"模式。

  • 一步到位写文件 → 用json.dump(),更安全简洁
  • 需要中间处理字符串(比如拼接、校验、加BOM)→ 用json.dumps(),再f.write()
  • 用dumps()时若要写文件,仍需open(..., "w", encoding="utf-8"),不能省

复杂点在于:一旦涉及BOM、流式写入、追加模式或权限控制,就得切回dumps() + 手动写入,这时候ensure_ascii和encoding两个地方都得盯紧。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1851

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

5044

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1809

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

30417

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3607

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3627

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1243

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

616

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2803

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程