如何使用Python操作JSON文件？读写方法详解

在Python开发中，JSON格式因为结构清晰、兼容性好，常被用来存储配置信息、接口返回数据等内容。Python标准库自带了json模块，不需要额外安装第三方库就能完成JSON文件的读写操作，使用起来非常方便。

JSON基础概念

JSON的全称是JavaScript Object Notation，本质是一种轻量级的数据交换格式。它的数据结构对应Python中的字典、列表、字符串、数字、布尔值和null，两者之间的转换规则是固定的，这也是Python能直接处理JSON文件的基础。

Python数据类型和JSON数据类型的对应关系如下：

读取JSON文件的方法

读取JSON文件主要使用json.load()函数，这个函数可以直接接收文件对象，把文件内容解析成对应的Python数据类型。

基础读取示例

假设我们有一个名为data.json的文件，内容如下：

{
    "name": "张三",
    "age": 25,
    "hobbies": ["读书", "跑步"],
    "is_student": false
}

使用以下代码可以读取这个文件：

import json

# 打开JSON文件并读取内容
with open("data.json", "r", encoding="utf-8") as f:
    data = json.load(f)

print(type(data))  # 输出 <class 'dict'>
print(data["name"])  # 输出 张三
print(data["hobbies"])  # 输出 ['读书', '跑步']

读取时的常见参数

json.load()函数支持一些常用参数，比如encoding用来指定文件编码，避免中文乱码；object_hook可以自定义解析规则，比如把JSON的object转换成自定义类的实例。

写入JSON文件的方法

写入JSON文件主要使用json.dump()函数，它可以将Python数据类型转换成JSON格式并写入到文件对象中。

基础写入示例

下面的代码会把一个Python字典写入到output.json文件中：

import json

user_info = {
    "username": "lisi",
    "score": 95.5,
    "passed": True,
    "extra": None
}

# 打开文件并写入JSON内容
with open("output.json", "w", encoding="utf-8") as f:
    json.dump(user_info, f, ensure_ascii=False, indent=4)

执行后生成的output.json文件内容如下：

{
    "username": "lisi",
    "score": 95.5,
    "passed": true,
    "extra": null
}

写入时的常用参数

• ensure_ascii：默认是True，会把所有非ASCII字符转义成Unicode编码，设置为False可以保留中文等字符，让文件内容更易读。
• indent：用来指定缩进的空格数，设置后会生成格式化的JSON文件，方便人工查看。
• sort_keys：设置为True时，会按照键的字母顺序排序输出JSON内容。

字符串和JSON的转换

除了直接操作文件，json模块还提供了json.loads()和json.dumps()函数，用来处理JSON格式的字符串，不需要依赖文件对象。

字符串转Python对象

import json

json_str = '{"id": 1, "title": "Python教程", "price": 49.9}'
result = json.loads(json_str)
print(result["title"])  # 输出 Python教程

Python对象转字符串

import json

book = {
    "id": 2,
    "title": "JSON入门",
    "author": "王五"
}
json_str = json.dumps(book, ensure_ascii=False)
print(json_str)  # 输出 {"id": 2, "title": "JSON入门", "author": "王五"}

异常处理注意事项

操作JSON文件时可能会遇到各种异常，比如文件不存在、JSON格式错误等，建议添加异常处理逻辑保证程序稳定。

import json
import os

file_path = "test.json"

if not os.path.exists(file_path):
    print("文件不存在")
else:
    try:
        with open(file_path, "r", encoding="utf-8") as f:
            data = json.load(f)
        print("读取成功")
    except json.JSONDecodeError:
        print("JSON格式错误，无法解析")
    except Exception as e:
        print(f"发生其他错误：{e}")

注意：如果JSON文件中包含datetime等Python特有的数据类型，直接使用json模块会报错，需要自定义编码器来处理这类特殊类型的转换。

PythonJSON文件读写json_module修改时间：2026-07-07 17:12:29