如何将json转成列表

如何将JSON数据转换为Python列表：从基础到实践

在Python开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，常用于前后端数据传输、配置文件存储等场景，而列表（List）是Python中最常用的数据结构之一，能够灵活存储有序的元素，将JSON数据转换为列表，是数据处理中的常见需求，本文将从JSON的基本结构出发，详细介绍不同场景下JSON转列表的方法,并附上实用代码示例。

理解JSON与列表的基本结构

在转换前，需先明确JSON和Python列表的对应关系：

JSON的数组（用[]表示）直接对应Python的列表（list）。
JSON的对象（用表示，键值对形式）对应Python的字典（dict），若需将对象的值转为列表，需提取特定字段。

JSON数组["apple", "banana", "orange"]可直接转为Python列表["apple", "banana", "orange"]；而JSON对象{"fruits": ["apple", "banana"], "vegetables": ["carrot"]}中，"fruits"的值本身是列表,可通过键提取。

核心方法：使用`json`模块解析JSON字符串

Python内置的json模块提供了 loads() 和 load() 两个核心函数，用于将JSON数据转换为Python对象（包括列表）。

处理JSON字符串：`json.loads()`

若JSON数据以字符串形式存在（如从API响应、文件读取的文本），需用json.loads()将其解析为Python列表。

语法：

import json
python_list = json.loads(json_string)

示例：
假设有一个JSON字符串，表示学生成绩列表：

json_str = '[{"name": "张三", "score": 90}, {"name": "李四", "score": 85}]'

通过json.loads()转换为Python列表：

import json
student_list = json.loads(json_str)
print(student_list)

输出：

[{'name': '张三', 'score': 90}, {'name': '李四', 'score': 85}]

student_list是一个包含字典的列表,每个字典代表一个学生的信息。

处理JSON文件：`json.load()`

若JSON数据存储在文件中（如data.json），需用json.load()直接读取并解析文件对象。

步骤：

用open()以读取模式打开JSON文件（建议指定encoding="utf-8"避免编码问题）。
将文件对象传递给json.load()，得到Python列表。

示例：
假设data.json为：

["苹果", "香蕉", "橙子", {"fruit": "葡萄"}]

读取并转换为列表：

import json
with open("data.json", "r", encoding="utf-8") as f:
    fruit_list = json.load(f)
print(fruit_list)

输出：

['苹果', '香蕉', '橙子', {'fruit': '葡萄'}]

注意：若JSON文件本身是对象（如{"fruits": [...]}），json.load()会返回字典，需进一步提取列表部分（如fruit_list = json.load(f)["fruits"]）。

处理复杂嵌套结构的JSON

实际场景中，JSON可能包含多层嵌套（如数组中嵌套对象、对象中嵌套数组）,需通过遍历或索引提取目标列表。

从嵌套JSON中提取列表

假设JSON数据包含多层结构，需定位目标列表：

json_data = {
    "school": "实验小学",
    "classes": [
        {"class_name": "一年级1班", "students": ["小明", "小红"]},
        {"class_name": "一年级2班", "students": ["小刚", "小美"]}
    ]
}

目标：提取所有学生的列表（合并两个班级的学生）。

方法：遍历外层列表，提取"students"字段并合并：

import json
# 若JSON是字符串，先解析为字典：data = json.loads(json_data_str)
all_students = []
for class_info in json_data["classes"]:
    all_students.extend(class_info["students"])
print(all_students)

输出：

['小明', '小红', '小刚', '小美']

将JSON对象的所有值转为列表

若JSON对象是键值对形式，需将其所有值提取为列表：

json_obj = {"a": 1, "b": [2, 3], "c": "hello", "d": {"x": 10}}

目标：获取所有值的列表（忽略键）。

方法：使用dict.values()结合列表推导式：

import json
values_list = list(json_obj.values())
print(values_list)

输出：

[1, [2, 3], 'hello', {'x': 10}]

若需递归提取所有值（包括嵌套对象的值），可编写递归函数,此处不再展开。

常见错误与注意事项

在JSON转列表时,以下问题需特别注意：

JSON格式错误

若JSON字符串格式不正确（如缺少引号、逗号），json.loads()会抛出json.JSONDecodeError。
示例：

invalid_json = '{"name": "张三", "score": 90}'  # 缺少结尾大括号
try:
    json.loads(invalid_json)
except json.JSONDecodeError as e:
    print(f"JSON格式错误: {e}")

解决方案：使用在线JSON格式化工具（如JSONLint）检查语法，或确保字符串中的引号、括号成对匹配。

编码问题

读取JSON文件时，若文件编码与程序默认编码不一致（如文件是UTF-8，但未指定encoding="utf-8"），可能导致乱码。
示例：

# 错误：未指定编码，可能导致中文乱码
with open("data.json", "r") as f:
    data = json.load(f)

解决方案：始终在open()中指定encoding="utf-8"。

数据类型不匹配

JSON中的null对应Python的None，true/false对应True/False，数字类型（int/float）直接对应，无需额外处理，但需注意：

JSON数组中的元素类型可以混合（如[1, "a", true]），转换后Python列表也会保留混合类型。

实践案例：从API响应中提取列表数据

假设通过API获取城市天气数据，返回的JSON格式如下：

{
    "status": "success",
    "data": [
        {"city": "北京", "temperature": 25, "weather": "晴"},
        {"city": "上海", "temperature": 28, "weather": "多云"},
        {"city": "广州", "temperature": 30, "weather": "雨"}
    ]
}

目标：提取所有城市的名称列表。

代码实现：

import json
import requests  # 假设使用requests库发送API请求
# 模拟API响应（实际开发中用requests.get(url)获取）
api_response = requests.get("https://api.example.com/weather")
json_str = api_response.text  # 获取JSON字符串
# 解析JSON并提取城市列表
weather_data = json.loads(json_str)
city_list = [item["city"] for item in weather_data["data"]]
print(city_list)

输出：