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

Python中的JSON处理（标准库）

news 2026/3/27 0:37:52

一、什么是JSON？

JSON（JavaScript Object Notation）是一种基于文本的开放标准，用于表示结构化数据。它采用键值对的形式组织数据，支持以下基本数据类型：

字符串（string）
数字（number）
布尔值（true / false）
空值（null）
对象（object，即键值对集合）
数组（array，即有序列表）

例如，一个简单的 JSON 数据如下：

{ "name": "张三", "age": 25, "is_student": true, "hobbies": ["读书", "游泳"], "address": null }

二、Python中的json模块

Python 的标准库json提供了将 Python 对象序列化为 JSON 字符串，以及将 JSON 字符串反序列化为 Python 对象的功能。该模块无需安装，直接导入即可使用：

import json

主要函数

函数	功能
`json.dumps(obj)`	将 Python 对象转换为 JSON 字符串
`json.loads(s)`	将 JSON 字符串解析为 Python 对象
`json.dump(obj, file)`	将 Python 对象写入文件（以 JSON 格式）
`json.load(file)`	从文件读取 JSON 数据并解析为 Python 对象

三、数据类型映射关系

Python 与 JSON 在数据类型上存在一定的映射关系：

Python 类型	JSON 类型
`dict`	object
`list`,`tuple`	array
`str`	string
`int`,`float`	number
`True`	true
`False`	false
`None`	null

注意：Python 中的tuple会被转换为 JSON 的array，但反向解析时会变成list。

四、基本用法示例

1. 序列化：Python对象 → JSON字符串（dumps）

import json data = { "name": "李四", "age": 30, "is_employee": True, "skills": ["Python", "Django", "Flask"], "address": None } # 转换为JSON字符串 json_str = json.dumps(data, ensure_ascii=False, indent=2) print(json_str)

输出结果：

{ "name": "李四", "age": 30, "is_employee": true, "skills": [ "Python", "Django", "Flask" ], "address": null }

参数说明：

ensure_ascii=False：允许非ASCII字符（如中文）正常显示，否则会转义。
indent=2：美化输出，使用2个空格缩进，便于阅读。

2. 反序列化：JSON字符串 → Python对象（loads）

json_string = ''' { "title": "Python入门教程", "pages": 256, "available": true, "tags": ["编程", "学习"] } ''' data = json.loads(json_string) print(type(data)) # <class 'dict'> print(data['title']) # Python入门教程

3. 写入JSON文件（dump）

with open('data.json', 'w', encoding='utf-8') as f: json.dump(data, f, ensure_ascii=False, indent=4)

这会将data对象写入名为data.json的文件中，并以 UTF-8 编码保存，支持中文。

4. 读取JSON文件（load）

with open('data.json', 'r', encoding='utf-8') as f: loaded_data = json.load(f) print(loaded_data)

五、常见问题与注意事项

1. 处理中文乱码

默认情况下，json.dumps()会将非 ASCII 字符转义（如\u4e2d\u6587），需设置ensure_ascii=False才能正确显示中文。

2. 自定义对象无法直接序列化

Python 中自定义类的对象不能直接被json序列化。例如：

class Person: def __init__(self, name, age): self.name = name self.age = age p = Person("王五", 28) # json.dumps(p) # 报错：Object of type Person is not JSON serializable

解决方法：提供自定义的序列化函数或继承JSONEncoder。

方法一：使用`default`参数

def person_serializer(obj): if isinstance(obj, Person): return {'name': obj.name, 'age': obj.age} raise TypeError(f"Object of type {type(obj)} is not JSON serializable") json_str = json.dumps(p, default=person_serializer, ensure_ascii=False, indent=2) print(json_str)

方法二：自定义 JSONEncoder

class PersonEncoder(json.JSONEncoder): def default(self, obj): if isinstance(obj, Person): return {'name': obj.name, 'age': obj.age} return super().default(obj) json_str = json.dumps(p, cls=PersonEncoder, ensure_ascii=False, indent=2) print(json_str)