Python读取JSON文件的正确方法

本文详细讲解了Python读取JSON文件的核心方法与实战技巧，重点介绍如何用内置json模块的json.load()配合with open()安全高效地解析JSON文件，并强调必须显式指定encoding='utf-8'以避免中文乱码；同时厘清json.loads()与json.load()的关键区别——前者处理字符串，后者处理文件对象；针对路径错误、编码不匹配、JSON格式非法等常见报错，提供清晰排查思路和实用解决方案；还拓展介绍了json5库对带注释、单引号等非标准JSON文本的支持，让开发者既能扎实掌握标准用法，又能灵活应对真实项目中的复杂场景。

Python 读 JSON 文件很简单，核心是用内置的 json 模块配合文件操作。

用 json.load() 读取文件对象

这是最常用、最推荐的方式：先用 open() 打开文件，再把文件对象传给 json.load()。

• 确保文件编码是 UTF-8（中文不乱码），显式指定 encoding='utf-8'
• JSON 文件内容会被自动转成对应的 Python 数据类型（如 dict、list、str、int、bool、None）
• 记得用 with 语句，自动安全关闭文件

示例：

import json
<p>with open('data.json', encoding='utf-8') as f:
data = json.load(f)</p><p>print(type(data))  # 通常是 dict 或 list
print(data.get('name'))  # 按键取值，安全又方便
</p>

如果只有 JSON 字符串，用 json.loads()

注意区分：load() 读文件对象，loads()（带 s）读字符串。

• 适用于从网络请求、数据库或变量中拿到的是 JSON 格式的字符串
• 别误写成 json.load(json_str)，会报错

示例：

json_str = '{"city": "北京", "population": 2154}'
data = json.loads(json_str)  # 不是 load()
print(data['city'])  # 北京

常见问题和应对

读取失败？大概率是这几个原因：

• 文件路径错：检查文件是否真在当前目录，或用绝对路径/打印 os.getcwd() 确认位置
• 编码不对：Windows 上保存的 JSON 有时是 GBK，可试 encoding='gbk'
• JSON 格式非法：多逗号、单引号、中文标点、尾部逗号等都会报 JSONDecodeError，用在线 JSON 验证工具（如 json.cn）检查
• 权限不足：Linux/macOS 下确认有读权限；Windows 下检查文件是否被其他程序占用

进阶：读取时跳过注释或兼容非标准 JSON

标准 json 模块不支持注释（// 或 /* */）和单引号。如需处理这类“类 JSON”文本：

• 用第三方库 json5（pip install json5），它兼容注释、单引号、末尾逗号等
• 或用 ast.literal_eval()（仅限简单结构，且要求格式非常接近 Python 字面量）

示例（json5）：

import json5
<p>with open('config.json5', encoding='utf-8') as f:
config = json5.load(f)  # 支持 // 注释和 'xxx'
</p>

基本上就这些。标准场景用 json.load() + with open() 就够了，注意编码和格式，基本不会出错。

好了，本文到此结束，带大家了解了《Python读取JSON文件的正确方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！