Python解析JSON文件的核心方法与排错指南

Python解析JSON的基础认知

JSON（JavaScript Object Notation）是一种轻量级的跨平台数据交换格式。它基于文本结构，语法简洁，不仅易于人工阅读编写，也被绝大多数编程语言原生支持。在Python中处理API返回数据、配置文件或日志分析时，解析JSON是高频刚需。

读取本地JSON文件的标准操作

第1步：准备符合规范的JSON数据源

解析前需确保目标文件为合法JSON格式。例如包含对象数组的权限描述文件：

[
  {
    "Key": "android.permission.ACCESS_CHECKIN_PROPERTIES",
    "Title": "访问检入属性",
    "Memo": "允许对检入服务上传的属性进行读/写访问。普通应用程序不能使用此权限。",
    "Level": 0
  },
  {
    "Key": "android.permission.ACCESS_COARSE_LOCATION",
    "Title": "大概位置",
    "Memo": "访问大概的位置源以确定手机的大概位置。恶意应用程序可借此定位您。",
    "Level": 1
  }
]

注意：JSON标准要求键名必须使用双引号包裹，且末尾不能有多余的逗号。

第2步：使用内置json模块安全加载文件

推荐使用上下文管理器自动处理文件关闭与异常捕获，避免资源泄漏：

import json

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

执行后，内存中的 data 变量将自动转换为Python的列表（List），其中每个元素为对应的字典（Dict）。

第3步：精准提取目标字段内容

通过索引定位数组项，再使用键名获取具体信息。例如打印第二条数据的说明字段：

# 提取索引为1的对象中的Memo字段
print(data[1]['Memo'])

若需批量处理，可直接遍历该列表：

for item in data:
    print(f"{item['Key']} -> {item['Memo']}")

解析JSON字符串的快捷方式

当数据以网络请求或变量形式存在而非独立文件时，可使用 json.loads()（String to Dictionary）直接转换：

import json

json_str = '{"name":"测试项", "type":{"name":"seq", "parameter":["A", "B"]}}'
result = json.loads(json_str)

print(result.keys())               # 输出顶层键名
print(result["name"])              # 输出：测试项
print(result["type"]["name"])      # 输出：seq
print(result["type"]["parameter"][1]) # 输出：B

常见报错排查与规范建议

在实际操作中，开发者常遇到 ValueError: No JSON object could be decoded 错误。该问题通常由以下原因触发：

• 文件头包含BOM标记：部分编辑器默认保存UTF-8带BOM格式，会导致解析器读取到非法起始字符。解决方法：使用代码编辑器将文件另存为“UTF-8 无BOM”格式后重新运行。
• 语法不符合标准：使用了单引号包裹键名、遗留了尾随逗号或未闭合括号。建议启用JSON验证插件实时检查。
• 文件路径或权限错误：Windows环境下反斜杠 \ 可能被误识别为转义符。建议使用原始字符串 r'C:\path\to\file.json' 或正斜杠 / 替代。

以上就是使用Python解析JSON文件与字符串的详细操作指引，更多关于Python数据处理与自动化脚本编写的资料请关注本站其它相关文章！