python操作json的核心是使用json模块的四个函数。1.json.loads()将json字符串转为python对象；2.json.dumps()将python对象转为json字符串，可设置indent美化格式；3.json.load()从文件读取json数据；4.json.dump()将python数据写入json文件。常见问题包括编码错误、数据类型不匹配和json解析异常，需注意ensure_ascii=false支持中文、处理布尔值与none的转换及捕获jsondecodeerror。对于嵌套结构，可通过链式访问逐层提取数据，结合.get()方法安全处理缺失字段。
在Python里操作JSON，其实远没有听起来那么复杂。核心就是利用Python自带的json模块，它能帮你轻松实现Python数据结构（比如字典和列表）与JSON字符串之间的转换。无论是从文件读取，还是把数据写入文件，亦或是直接处理内存中的字符串，json模块都提供了直观且强大的接口。
解决方案
要用Python操作JSON，你主要会用到json.loads()、json.dumps()、json.load()和json.dump()这四个函数。
-
从JSON字符串加载数据到Python对象：json.loads() 当你手头有一个JSON格式的字符串，想把它变成Python能理解的字典或列表时，loads（load String的缩写）就是你的首选。
import json json_str = '{"name": "张三", "age": 30, "isStudent": false, "courses": ["Math", "Physics"]}' data = json.loads(json_str) print(data) print(type(data)) # 输出：{'name': '张三', 'age': 30, 'isStudent': False, 'courses': ['Math', 'Physics']} # 输出：<class 'dict'> -
将Python对象转换为JSON字符串：json.dumps() 反过来，如果你有一个Python字典或列表，想把它序列化成JSON格式的字符串，以便存储、传输或打印，dumps（dump string的缩写）就派上用场了。
import json py_dict = { "title": "Python JSON操作指南", "author": "一个爱折腾的开发者", "tags": ["Python", "JSON", "数据处理"], "version": 1.0 } json_output = json.dumps(py_dict, indent=4, ensure_ascii=False) # indent用于美化输出，ensure_ascii=False支持中文 print(json_output) # 输出： # { # "title": "Python JSON操作指南", # "author": "一个爱折腾的开发者", # "tags": [ # "Python", # "JSON", # "数据处理" # ], # "version": 1.0 # } -
从JSON文件加载数据到Python对象：json.load() 处理文件时，load（注意没有’s’）能直接从打开的文件对象中读取JSON数据。这比先读取整个文件内容到字符串再用loads效率更高，也更方便。 假设你有一个名为data.json的文件，内容是：
{ "city": "北京", "temperature": 25, "forecast": ["晴", "多云"] }import json try: with open('data.json', 'r', encoding='utf-8') as f: file_data = json.load(f) print(file_data) # 输出：{'city': '北京', 'temperature': 25, 'forecast': ['晴', '多云']} except FileNotFoundError: print("文件 data.json 不存在，请先创建。")
-
将Python对象写入JSON文件：json.dump() 要将Python对象直接写入JSON文件，使用dump。它会帮你处理文件写入的细节，同样可以指定indent参数让文件内容更易读。
import json new_data = { "product": "智能音箱", "price": 399.99, "features": ["语音控制", "蓝牙连接", "智能家居"] } with open('output.json', 'w', encoding='utf-8') as f: json.dump(new_data, f, indent=4, ensure_ascii=False) print("数据已成功写入 output.json 文件。") # output.json 的内容会是格式化后的JSON
Python处理JSON数据时常见的错误与应对策略
说实话，刚开始用Python处理JSON，踩坑是常有的事。最常见的几个问题，我个人经验来看，主要集中在编码、数据类型不匹配和错误处理上。
立即学习“Python免费学习笔记（深入）”；
一个很典型的错误就是编码问题。当你从外部文件或网络请求获取JSON数据时，如果文件的编码不是UTF-8，或者你的程序没有正确指定编码，就很容易遇到UnicodeDecodeError。JSON标准建议使用UTF-8，所以我的习惯是，无论读写文件，都明确加上encoding=’utf-8’。比如，open(‘file.json’, ‘r’, encoding=’utf-8′)。这能省去很多不必要的麻烦。
再来是数据类型映射的理解偏差。Python的None在JSON里对应的是NULL，Python的True/False对应的是true/false。如果你不小心把Python的布尔值当字符串存进去，或者反过来期望JSON的null能直接被Python识别成某个特定值，就可能出问题。json模块会自动帮你处理这些基本类型的转换，但如果你在Python代码里构造数据时用了非JSON兼容的类型（比如set），json.dumps()就会抛出TypeError。这时候你就得手动转换，比如把set转成list。
最后，也是我经常强调的，错误处理。不是所有的字符串都是合法的JSON。当json.loads()尝试解析一个格式错误的字符串时，它会抛出json.JSONDecodeError。所以，在实际项目中，尤其是在处理用户输入或外部API返回的数据时，一定要用try…except json.JSONDecodeError来捕获这个异常。这样可以防止程序崩溃，并给用户或日志提供有用的错误信息。
import json malformed_json_str = '{"name": "Alice", "age": 30,' # 少了个 } try: data = json.loads(malformed_json_str) print(data) except json.JSONDecodeError as e: print(f"解析JSON失败：{e}") print("请检查JSON字符串的格式是否正确。") # 输出：解析JSON失败：Expecting property name or '}' at line 1 column 28 (char 27) # 输出：请检查JSON字符串的格式是否正确。
如何优雅地美化和格式化JSON输出？
让JSON输出变得“好看”或者说“易读”，是调试和日志记录时非常重要的一个环节。json模块提供了几个参数，能让你轻松实现这一点。我个人在调试或者需要把JSON内容粘贴到文档里时，都会用到它们。
最常用的就是indent参数。当你把它设置为一个整数（比如4）时，json.dumps()或json.dump()会在每个层级缩进指定数量的空格，并为每个键值对添加换行符，让JSON结构一目了然。
import json complex_data = { "project": "ai助手", "developers": [ {"name": "李华", "role": "前端"}, {"name": "王明", "role": "后端", "skills": ["Python", "Django", "SQL"]} ], "status": "开发中", "milestones": { "phase1": "需求分析", "phase2": "原型设计", "phase3": "核心功能开发" } } # 不带缩进的输出，紧凑但难以阅读 print("--- 紧凑输出 ---") print(json.dumps(complex_data, ensure_ascii=False)) # 带4个空格缩进的输出，非常易读 print("n--- 格式化输出 (indent=4) ---") print(json.dumps(complex_data, indent=4, ensure_ascii=False))
除了indent，还有一个sort_keys参数也很有用。当sort_keys设置为True时，输出的JSON中，字典的键会按照字母顺序排序。这对于需要比较两个JSON文件是否完全相同（例如，自动化测试中对比预期输出和实际输出），或者仅仅是为了保持输出的一致性，都非常有帮助。因为JSON对象中的键是无序的，不同次运行dumps可能会得到键顺序不同的字符串，sort_keys=True就能解决这个问题。
import json data_to_sort = { "z_key": 1, "a_key": 2, "c_key": 3 } print("n--- 默认键顺序 (不保证) ---") print(json.dumps(data_to_sort, indent=2)) print("n--- 排序后的键顺序 ---") print(json.dumps(data_to_sort, indent=2, sort_keys=True))
通过这些参数，你可以根据不同的场景需求，灵活地控制JSON输出的格式，让它们要么紧凑高效，要么清晰易读。
处理嵌套JSON数据有哪些技巧？
JSON数据结构最迷人的地方，就是它天然支持嵌套。一个键的值可以是另一个JSON对象，也可以是json数组，数组里面又可以包含JSON对象……这种层层叠叠的结构，在表示复杂关系时特别方便。但处理起来，有时候确实会让人感觉像在“剥洋葱”。
核心技巧就是链式访问。Python在把JSON解析成字典和列表后，你就可以像操作普通Python字典和列表一样，一层一层地访问下去。
import json nested_json_str = """ { "company": "TechSolutions Inc.", "departments": [ { "name": "研发部", "employees": [ {"id": "001", "name": "王工程师", "projects": ["Project Alpha", "Project Beta"]}, {"id": "002", "name": "李架构师", "projects": ["Project Gamma"]} ], "location": {"city": "上海", "building": "A座"} }, { "name": "市场部", "employees": [ {"id": "003", "name": "张经理", "campaigns": ["Spring Sale"]} ], "location": {"city": "北京", "building": "B座"} } ], "established_year": 2010 } """ data = json.loads(nested_json_str) # 访问公司名称 print(f"公司名称: {data['company']}") # 访问第一个部门的名称 first_department = data['departments'][0] print(f"第一个部门: {first_department['name']}") # 访问第一个部门的第二个员工的名字和项目 second_employee = first_department['employees'][1] print(f"第二个员工: {second_employee['name']}, 参与项目: {second_employee['projects']}") # 访问第二个部门的城市 second_department_city = data['departments'][1]['location']['city'] print(f"第二个部门所在城市: {second_department_city}")
当数据结构变得非常复杂，或者你不确定某个键是否存在时，使用字典的.get()方法会比直接用[]访问更安全。get()方法允许你提供一个默认值，当键不存在时返回这个默认值，而不是抛出KeyError。这在处理可能缺失字段的JSON数据时尤其有用。
# 假设我们想获取一个可能不存在的部门 try: non_existent_department = data['departments'][2] # 索引2不存在 print(non_existent_department) except IndexError: print("部门索引超出范围。") # 使用 .get() 访问可能不存在的键 # 尝试获取一个不存在的员工ID employee_id = data['departments'][0]['employees'][0].get('employee_id', 'N/A') print(f"员工ID (可能不存在): {employee_id}") # 输出：员工ID (可能不存在): N/A # 尝试获取一个不存在的部门名称，返回None non_existent_dept_name = data.get('non_existent_department', {}).get('name') print(f"不存在的部门名称: {non_existent_dept_name}") # 输出：不存在的部门名称: None
对于非常深层或结构不固定的JSON，你可能需要编写递归函数来遍历整个结构，或者考虑使用jsonpath这样的第三方库，它们提供了类似XPath的查询语言来定位JSON中的特定元素。但对于大多数日常任务，掌握链式访问和.get()方法，就已经足够应对了。
