Python将字典写入JSON文件：json.dumps用法与缩进设置

木白

发布时间：2026-10-14 | 5人浏览过

原创

本文介绍Python中将字典内容保存为JSON文件的方法。核心步骤是使用json.dumps()函数将字典对象序列化为字符串，再通过文件写入操作保存。通过设置indent参数可实现格式化缩进输出，提升可读性。文章提供无缩进与有缩进两种代码示例，展示defaultdict与OrderedDict在JSON序列化中的应用。

Python字典写入JSON的核心方法

在Python中，将字典数据保存为JSON文件的基本流程是：首先调用json.dumps()函数对字典进行编码，生成对应的字符串表示；随后将该字符串写入目标JSON文件。json.dumps()函数负责完成数据到JSON格式字符串的转换编码工作。

当需要将字典内容写入JSON文件时，必须使用json.dumps()将字典转换为字符串格式，之后才能执行文件写入操作。

JSON格式支持通过indent参数设置缩进层级。若不指定该参数，生成的JSON字符串将压缩为单行格式；设置缩进后，输出内容将按层级格式化排列，便于阅读。

代码示例：缩进设置对比

具体实现示例如下：

未设置缩进的输出方式：


from collections import defaultdict, OrderedDict
import json

video = defaultdict(list)
video["label"].append("haha")
video["data"].append(234)
video["score"].append(0.3)
video["label"].append("xixi")
video["data"].append(123)
video["score"].append(0.7)

test_dict = {
    'version': "1.0",
    'results': video,
    'explain': {
        'used': True,
        'details': "this is for josn test",
  }
}

json_str = json.dumps(test_dict)
with open('test_data.json', 'w') as json_file:
    json_file.write(json_str)

设置缩进后的格式化输出：


from collections import defaultdict, OrderedDict
import json

video = defaultdict(list)
video["label"].append("haha")
video["data"].append(234)
video["score"].append(0.3)
video["label"].append("xixi")
video["data"].append(123)
video["score"].append(0.7)

test_dict = {
    'version': "1.0",
    'results': video,
    'explain': {
        'used': True,
        'details': "this is for josn test",
  }
}

json_str = json.dumps(test_dict, indent=4)
with open('test_data.json', 'w') as json_file:
    json_file.write(json_str)