python怎么读json文件

Python读JSON文件最常用方式是用json.load()配合with open(),需指定encoding='utf-8';字符串解析用json.loads();常见问题包括路径错误、编码不匹配、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

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

print(type(data)) # 通常是 dict 或 list print(data.get('name')) # 按键取值,安全又方便

如果只有 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

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

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