Python JSON文件读写深度解析：从基础到实战46

在现代软件开发中，数据交换格式扮演着至关重要的角色。其中，JSON (JavaScript Object Notation) 因其轻量级、人类可读性强以及易于机器解析的特性，已成为Web服务API、配置文件、数据持久化等场景的首选。作为一名专业的Python开发者，熟练掌握Python对JSON文件的读写操作是基本功。

Python内置的 `json` 模块提供了高效且易用的API，使得JSON数据的序列化（Python对象转换为JSON格式）和反序列化（JSON格式转换为Python对象）变得异常简单。本文将带您深入探讨Python如何读写JSON文件，从核心概念到实战技巧，助您轻松驾驭JSON数据处理。

一、JSON与Python数据类型的映射

在深入代码之前，理解JSON数据类型与Python数据类型之间的对应关系是基础：
JSON Object (对象) Python Dictionary (字典)
JSON Array (数组) Python List (列表)
JSON String (字符串) Python String (字符串)
JSON Number (数字) Python int 或 float (整数或浮点数)
JSON Boolean (布尔值) Python True 或 False (布尔值)
JSON null (空值) Python None (空值)

这种直观的映射是Python处理JSON数据高效便捷的关键。

二、核心模块与函数：`json`

Python处理JSON的主要工具是内置的 `json` 模块。它提供了四种核心函数用于数据的序列化和反序列化：
`()`: 将Python对象序列化为JSON格式，并写入文件。
`()`: 从文件中读取JSON格式数据，并反序列化为Python对象。
`()`: 将Python对象序列化为JSON格式的字符串。
`()`: 从JSON格式的字符串反序列化为Python对象。

在文件操作场景中，我们主要关注 `()` 和 `()`。

三、Python写入JSON文件（序列化）

将Python数据写入JSON文件是最常见的操作之一。这通常涉及将Python字典或列表转换为JSON字符串，然后保存到文件中。

3.1 基础写入示例

假设我们有一个Python字典，需要将其保存为JSON文件：
import json
# 待写入的Python数据
data = {
"name": "张三",
"age": 30,
"isStudent": False,
"courses": ["Math", "English", "Physics"],
"address": {
"street": "科技路123号",
"city": "北京"
}
}
# 指定文件名
file_path = ""
# 使用 'w' 模式打开文件，并指定编码
with open(file_path, 'w', encoding='utf-8') as f:
# 使用 () 将数据写入文件
(data, f)
print(f"数据已成功写入到 {file_path}")

执行上述代码后，`` 文件将包含一行紧凑的JSON数据。

3.2 提升JSON文件可读性：`indent` 参数

为了使JSON文件更易于人类阅读，`()` 提供了一个 `indent` 参数，用于指定缩进的空格数量：
import json
data = {
"name": "李四",
"age": 25,
"hobbies": ["reading", "coding", "traveling"],
"contact": {
"email": "lisi@",
"phone": "138xxxxxxxx"
}
}
file_path_pretty = ""
with open(file_path_pretty, 'w', encoding='utf-8') as f:
(data, f, indent=4) # 缩进4个空格
print(f"格式化数据已写入到 {file_path_pretty}")

现在，`` 将以美观的缩进格式呈现，每个层级缩进4个空格，大大提高了可读性。

3.3 处理中文字符：`ensure_ascii` 参数

默认情况下，`()` 会将非ASCII字符（如中文字符）转义为 `\uXXXX` 格式。如果您希望在JSON文件中直接显示中文字符而不是其Unicode转义序列，可以将 `ensure_ascii` 参数设置为 `False`。
import json
data_chinese = {
"name": "王五",
"city": "上海市",
"description": "一位热情的Python开发者。"
}
file_path_chinese = ""
with open(file_path_chinese, 'w', encoding='utf-8') as f:
(data_chinese, f, indent=4, ensure_ascii=False)
print(f"包含中文字符的数据已写入到 {file_path_chinese}")

重要提示：在使用 `ensure_ascii=False` 时，请务必确保文件是以 `utf-8` 编码打开和保存的，否则可能导致乱码。

3.4 保持键的顺序：`sort_keys` 参数

Python字典在3.7版本之后默认保持插入顺序，但JSON规范本身并不保证对象的键的顺序。如果您希望JSON文件中的键总是按字母顺序排列，可以使用 `sort_keys=True`。
import json
data_unordered = {
"zebra": 1,
"apple": 3,
"banana": 2
}
file_path_sorted = ""
with open(file_path_sorted, 'w', encoding='utf-8') as f:
(data_unordered, f, indent=4, sort_keys=True)
print(f"按键排序的数据已写入到 {file_path_sorted}")

在 `` 中，键将按照 "apple", "banana", "zebra" 的顺序显示。

四、Python读取JSON文件（反序列化）

从JSON文件读取数据通常涉及打开文件，然后使用 `()` 将JSON内容解析回Python对象。

4.1 基础读取示例

读取我们之前创建的 `` 文件：
import json
file_path_pretty = ""
# 使用 'r' 模式打开文件，并指定编码
with open(file_path_pretty, 'r', encoding='utf-8') as f:
# 使用 () 读取并反序列化数据
loaded_data = (f)
print("从JSON文件读取的数据:")
print(loaded_data)
print(f"数据类型: {type(loaded_data)}")
print(f"姓名: {('name')}")

执行后，`loaded_data` 将是一个Python字典，您可以像操作普通字典一样访问其中的数据。

4.2 错误处理

在实际应用中，文件可能不存在，或者JSON文件内容格式不正确。我们需要通过错误处理来增强代码的健壮性。
import json
import os # 用于检查文件是否存在
file_path_non_existent = ""
file_path_malformed = ""
# 创建一个格式错误的JSON文件作为示例
with open(file_path_malformed, 'w', encoding='utf-8') as f:
('{"key": "value", "another_key": }') # 故意留下语法错误
# 尝试读取一个不存在的文件
try:
with open(file_path_non_existent, 'r', encoding='utf-8') as f:
data = (f)
except FileNotFoundError:
print(f"错误: 文件 '{file_path_non_existent}' 不存在。")
except as e:
print(f"错误: 解析JSON失败，文件 '{file_path_non_existent}' 格式不正确。详细: {e}")
except Exception as e:
print(f"发生未知错误: {e}")
# 尝试读取一个格式错误的JSON文件
try:
with open(file_path_malformed, 'r', encoding='utf-8') as f:
data = (f)
except FileNotFoundError:
print(f"错误: 文件 '{file_path_malformed}' 不存在。")
except as e:
print(f"错误: 解析JSON失败，文件 '{file_path_malformed}' 格式不正确。详细: {e}")
except Exception as e:
print(f"发生未知错误: {e}")
finally:
# 清理创建的错误文件
if (file_path_malformed):
(file_path_malformed)

通过 `try...except` 语句，我们可以捕获 `FileNotFoundError`（文件不存在）和 ``（JSON格式错误），从而提高程序的稳定性。

五、最佳实践与注意事项

使用 `with open()` 语句：
这是Python文件操作的最佳实践。它确保文件在操作完成后能够自动关闭，即使发生异常也能正确释放资源，避免资源泄露。

指定文件编码：
在打开文件时，始终明确指定 `encoding='utf-8'`。UTF-8是处理多语言文本的黄金标准，可以有效避免乱码问题，尤其是在处理包含中文字符的JSON文件时。

错误处理：
如前所示，为 `FileNotFoundError` 和 `` 提供适当的错误处理是构建健壮应用程序的关键。

可读性：
在开发和调试阶段，或当JSON文件需要人工审查时，使用 `indent` 参数来格式化输出是很有帮助的。在生产环境中，如果文件大小是关键因素，可以省略 `indent` 以生成更紧凑的JSON。

自定义对象序列化/反序列化：
`json` 模块默认只能处理Python的内置类型。如果您需要序列化自定义类的实例（例如，将类的对象保存为JSON），需要提供一个 `default` 函数给 `` 或 ``，或继承 ``。类似地，反序列化自定义对象则需要自定义 `object_hook` 函数或继承 ``。

性能与大数据：
对于非常大的JSON文件（GB级别），一次性加载到内存中可能会导致内存溢出。在这种情况下，可以考虑使用流式解析（streaming parsing）库，如 `ijson`，或者将大文件分块处理。

安全性：
JSON通常被认为是安全的数据格式，但如果JSON数据中包含恶意代码并尝试使用 `eval()` 等函数执行，则存在安全风险。始终避免对不受信任的JSON源使用 `eval()`，而是通过 `()` 或 `()` 安全地反序列化。

六、总结

Python 的 `json` 模块功能强大且易于掌握，为处理JSON数据提供了完整且灵活的解决方案。通过 `()` 和 `()`，我们可以方便地将Python对象与JSON文件之间进行转换。掌握 `indent`、`ensure_ascii` 和错误处理等高级技巧，将使您的代码更加专业、健壮和用户友好。

无论是进行API通信、保存应用程序配置、实现数据持久化，还是进行数据交换，Python的JSON处理能力都使其成为这些任务的首选工具。希望本文能帮助您全面理解并熟练运用Python读写JSON文件，从而在您的开发工作中游刃有余。

2025-10-08

上一篇：构建高质量Python代码：深入理解其结构与设计原则

下一篇：Python 函数调用深度解析：从基础到高级，玩转函数间通信与协作