当前位置：首页 > news >正文

Python JSON 操作指南：4 个核心方法一文吃透

news 2026/8/21 21:48:08

在 Python 开发中，JSON 是最常用的数据交换格式，无论是接口数据传输、配置文件读写，还是数据持久化，都离不开json模块。但很多新手容易混淆dump/dumps/load/loads四个方法，今天就用最通俗的语言、最全的案例，帮你彻底搞定 Python JSON 操作！

一、先搞懂：4 个核心方法的核心区别

json模块的 4 个方法，本质是 **「数据类型转换」和「文件读写」** 的组合，一句话区分：

带s的（dumps/loads）：操作字符串（内存中转换，不读写文件）
不带s的（dump/load）：操作文件（直接读写文件，一步到位）
dump开头：Python 对象 → JSON（序列化）
load开头：JSON → Python 对象（反序列化）

二、序列化：Python 对象 → JSON 格式

序列化就是把 Python 里的字典、列表，转换成标准的 JSON 格式，分转字符串和写文件两种场景。

1. json.dumps ()：转 JSON 字符串（最常用）

适合需要在内存中使用 JSON 字符串的场景，比如打印、接口返回数据。关键参数：

ensure_ascii=False：保留中文（默认会把中文转成 Unicode 编码）
indent=4：格式化缩进，让 JSON 更易读

import json # 定义 Python 字典 student = { "name": "张三", "age": 22, "major": "计算机科学", "hobbies": ["编程", "篮球", "阅读"] } # 转换为 JSON 字符串（保留中文+格式化） json_str = json.dumps(student, ensure_ascii=False, indent=4) # 输出结果：标准 JSON 格式字符串 print("JSON 字符串：") print(json_str) print("类型：", type(json_str)) # <class 'str'>

2. json.dump ()：直接写入 JSON 文件

适合需要把数据持久化保存到文件的场景，一步完成转换 + 写入，无需手动处理字符串。

import json student = { "name": "李四", "age": 23, "major": "人工智能" } # 打开文件，直接写入 JSON 数据 with open("student.json", "w", encoding="utf-8") as f: # 参数：Python对象 + 文件对象 + 格式化参数 json.dump(student, f, ensure_ascii=False, indent=4) # 执行后：桌面/代码目录会生成 student.json 文件

三、反序列化：JSON 格式 → Python 对象

反序列化就是把 JSON 数据，转回 Python 能直接操作的字典、列表，同样分解析字符串和读文件两种场景。

1. json.loads ()：解析 JSON 字符串

适合处理接口返回的字符串、变量中的 JSON 数据，转回 Python 字典后可直接取值。

import json # 模拟 JSON 字符串（比如接口返回的数据） json_str = ''' { "name": "张三", "age": 22, "major": "计算机科学", "hobbies": ["编程", "篮球", "阅读"] } ''' # 转换为 Python 字典 python_dict = json.loads(json_str) # 直接像字典一样取值 print("姓名：", python_dict["name"]) # 张三 print("年龄：", python_dict["age"]) # 22 print("类型：", type(python_dict)) # <class 'dict'>

2. json.load ()：直接读取 JSON 文件

适合读取本地 JSON 配置文件、数据文件，一步完成读取 + 转换。

import json # 读取刚才写入的 student.json 文件 with open("student.json", "r", encoding="utf-8") as f: # 直接从文件转换为 Python 字典 python_dict = json.load(f) print("读取文件数据：", python_dict) print("专业：", python_dict["major"]) # 人工智能

四、新手必避的 3 个坑

坑 1：混淆 dump 和 dumps（报错根源）

想转字符串却用json.dump()→ 报TypeError: dump() missing 1 required positional argument: 'fp'
正确：转字符串用dumps()，写文件用dump()

坑 2：中文乱码

必须加ensure_ascii=False，否则中文会变成\u5f20\u4e09这类 Unicode 编码。

坑 3：JSON 格式不标准

JSON 语法严格：键必须用双引号，不能用单引号；最后一个元素后不能加逗号。

# 错误（单引号） error_json = "{'name': '张三'}" # 正确（双引号） right_json = '{"name": "张三"}'

五、完整实战案例：数据读写闭环

import json # 1. 定义 Python 数据 data = { "title": "Python JSON 教程", "author": "编程新手", "content": "4个方法搞定 JSON 操作", "like": 100 } # 2. 序列化：转 JSON 字符串 json_str = json.dumps(data, ensure_ascii=False, indent=4) print("序列化完成：\n", json_str) # 3. 写入文件 with open("blog.json", "w", encoding="utf-8") as f: json.dump(data, f, ensure_ascii=False, indent=4) # 4. 读取文件并反序列化 with open("blog.json", "r", encoding="utf-8") as f: read_data = json.load(f) # 5. 验证结果 print("\n读取文件后的数据：") print(f"标题：{read_data['title']}") print(f"作者：{read_data['author']}")