列表用于按顺序保存多个值。课程主题、待处理任务、模型消息和接口返回的记录,都可以先放进列表中,再逐个读取或处理。
使用方括号创建列表,元素之间用逗号分隔:
1topics = ["变量", "条件语句", "for 循环"] 2numbers = [1, 2, 3, 4] 3empty = [] 4 5print(topics) 6print(numbers) 7print(empty)
列表可以保存不同类型的值,但实际项目中通常让同一个列表中的元素具有相近的含义:
1profile = ["小明", 18, True] 2 3print(profile)
也可以使用 list() 把其他可遍历对象转换成列表:
list()
1letters = list("Python") 2numbers = list(range(3)) 3 4print(letters) # ['P', 'y', 't', 'h', 'o', 'n'] 5print(numbers) # [0, 1, 2]
列表是可变对象。创建空列表后,可以通过方法逐步添加数据:
1tasks = [] 2 3tasks.append("读取文件") 4tasks.append("处理数据") 5 6print(tasks)
列表中的元素按照位置保存,索引从 0 开始:
0
1topics = ["变量", "列表", "字符串"] 2 3print(topics[0]) # 变量 4print(topics[1]) # 列表 5print(topics[-1]) # 字符串
如果索引超出范围,会抛出 IndexError。读取不确定长度的列表时,可以先使用 len() 判断:
IndexError
len()
1topics = ["变量", "列表"] 2 3if len(topics) > 2: 4 print(topics[2]) 5else: 6 print("没有第三个主题")
切片可以得到一部分元素,规则和字符串切片一样:开始位置包含,结束位置不包含:
1topics = ["变量", "列表", "字符串", "条件语句"] 2 3print(topics[0:2]) # ['变量', '列表'] 4print(topics[2:]) # ['字符串', '条件语句'] 5print(topics[:3]) # ['变量', '列表', '字符串'] 6print(topics[::-1]) # 倒序列表
in 和 not in 用来判断元素是否存在:
in
not in
1topics = ["变量", "列表", "字符串"] 2 3if "列表" in topics: 4 print("已经学习列表") 5 6if "字典" not in topics: 7 print("还没有学习字典")
列表可以通过索引修改某个元素:
1topics = ["变量", "数组", "字符串"] 2topics[1] = "列表" 3 4print(topics)
append() 在列表末尾添加一个元素,extend() 则把另一个可遍历对象中的元素逐个添加进去:
append()
extend()
1topics = ["变量"] 2 3topics.append(["列表", "字符串"]) 4print(topics) # ['变量', ['列表', '字符串']] 5 6topics = ["变量"] 7topics.extend(["列表", "字符串"]) 8print(topics) # ['变量', '列表', '字符串']
append() 会把参数作为一个整体放进去,extend() 会展开参数中的元素。两者的结果不同,选择时要先明确自己想要哪一种结构。
列表还可以使用 + 拼接。它会按照顺序连接两个列表,并返回一个新的列表,不会修改原来的列表:
+
1basic_topics = ["变量", "列表"] 2advanced_topics = ["模块", "函数"] 3 4all_topics = basic_topics + advanced_topics 5 6print(all_topics) # ['变量', '列表', '模块', '函数'] 7print(basic_topics) # ['变量', '列表']
+ 两边都必须是列表,不能直接把列表和一个单独的元素相加。需要把多个元素追加到原列表时,可以使用 +=:
+=
1topics = ["变量"] 2topics += ["列表", "字符串"] 3 4print(topics) # ['变量', '列表', '字符串']
可以简单地这样区分:+ 生成新的列表,+= 把右侧列表中的元素加入当前列表。
insert(index, value) 可以在指定位置插入元素:
insert(index, value)
1topics = ["变量", "字符串"] 2topics.insert(1, "列表") 3 4print(topics)
删除元素时,remove() 按值删除第一次出现的元素,pop() 按索引删除并返回元素:
remove()
pop()
1topics = ["变量", "列表", "字符串", "列表"] 2 3topics.remove("列表") 4last_topic = topics.pop() 5 6print(topics) # ['变量', '字符串'] 7print(last_topic) # 列表
如果列表中不存在要删除的值,remove() 会抛出 ValueError;如果索引不存在,pop() 会抛出 IndexError。不确定数据是否存在时,先用 in 检查,或者捕获异常。
ValueError
clear() 会删除列表中的所有元素,但保留列表对象本身:
clear()
1tasks = ["读取文件", "保存结果"] 2tasks.clear() 3 4print(tasks) # []
列表提供了几个常用的统计和查找方法:
len(list)
count(value)
index(value)
min(list)
max(list)
sum(list)
1scores = [82, 95, 76, 82] 2 3print(len(scores)) # 4 4print(scores.count(82)) # 2 5print(scores.index(95)) # 1 6print(min(scores)) # 76 7print(max(scores)) # 95 8print(sum(scores)) # 335
调用 index() 前最好先确认元素存在,否则找不到值时会抛出 ValueError:
index()
1topics = ["变量", "列表", "字符串"] 2target = "字典" 3 4if target in topics: 5 print(topics.index(target)) 6else: 7 print("没有找到这个主题")
列表可以使用 sort() 原地排序,也可以使用 sorted() 生成一个新的排序结果:
sort()
sorted()
1scores = [82, 95, 76, 88] 2 3scores.sort() 4print(scores) # [76, 82, 88, 95] 5 6descending = sorted(scores, reverse=True) 7print(descending) # [95, 88, 82, 76]
sort() 会直接改变原列表,sorted() 不会改变原列表。只想查看排序结果、还需要保留原始顺序时,优先使用 sorted()。
字符串列表也可以按照字符串长度排序:
1topics = ["列表", "Python", "字符串"] 2 3ordered = sorted(topics, key=len) 4print(ordered)
for 循环是处理列表中每个元素最常见的方式:
for
1topics = ["变量", "列表", "字符串"] 2 3for topic in topics: 4 print(f"正在学习:{topic}")
如果需要同时使用下标,可以使用 enumerate():
enumerate()
1topics = ["变量", "列表", "字符串"] 2 3for index, topic in enumerate(topics, start=1): 4 print(f"第 {index} 个主题:{topic}")
遍历时也可以配合条件语句完成筛选或统计:
1scores = [58, 76, 91, 42, 68] 2passed = [] 3 4for score in scores: 5 if score >= 60: 6 passed.append(score) 7 8print(passed) # [76, 91, 68]
如果只是根据一个简单条件生成新列表,可以使用列表推导式:
1scores = [58, 76, 91, 42, 68] 2passed = [score for score in scores if score >= 60] 3 4print(passed)
列表推导式只是 for 循环的一种简写。刚开始学习时,可以先读懂普通循环,再使用推导式;如果条件和转换逻辑太复杂,普通循环通常更容易维护。
列表经常与字典、循环和条件语句组合使用,保存一组结构相同的数据:
01users = [ 02 {"name": "小明", "active": True}, 03 {"name": "小红", "active": False}, 04 {"name": "小李", "active": True}, 05] 06 07active_names = [] 08for user in users: 09 if user["active"]: 10 active_names.append(user["name"]) 11 12print(active_names) # ['小明', '小李']
列表也可以嵌套列表,用来表达二维数据:
1table = [ 2 ["姓名", "分数"], 3 ["小明", 82], 4 ["小红", 95], 5] 6 7print(table[1][0]) # 小明 8print(table[2][1]) # 95
复制列表时要注意:直接赋值不会创建新列表,只是让两个变量指向同一个列表:
1original = ["变量", "列表"] 2alias = original 3alias.append("字符串") 4 5print(original) # ['变量', '列表', '字符串']
如果需要一个独立的列表,可以使用切片、copy() 或 list():
copy()
1original = ["变量", "列表"] 2copied = original.copy() 3copied.append("字符串") 4 5print(original) # ['变量', '列表'] 6print(copied) # ['变量', '列表', '字符串']
这些方式是浅复制。如果列表中还嵌套了其他列表,内部列表仍然可能被共享。初学阶段先记住:简单的一维列表可以用 copy(),复杂嵌套结构需要进一步了解深复制。
下面的例子把带空格的课程名称清理后排序,展示列表在实际数据处理中的组合用法:
01raw_topics = [" Python ", "列表", "", "字符串 "] 02topics = [] 03 04for raw_topic in raw_topics: 05 topic = raw_topic.strip() 06 if topic: 07 topics.append(topic) 08 09topics.sort() 10print(topics) # ['Python', '列表', '字符串']
这个接口接收课程主题与成绩列表。实验分别复制原列表再执行操作,因此 append、extend、删除和排序不会互相干扰,也不会累积到下次请求。
main.py 提供接口,lists_demo.py 执行实验。下面展示的代码与在线编辑器的初始文件来自同一份源码;修改编辑器中的文件后,保存并重新运行,接口就会使用修改后的内容。
01from typing import Annotated 02 03from fastapi import FastAPI 04from pydantic import BaseModel, Field 05 06from lists_demo import build_report 07 08app = FastAPI() 09Topic = Annotated[str, Field(max_length=100)] 10Score = Annotated[int, Field(ge=0, le=100)] 11 12class ListRequest(BaseModel): 13 topics: list[Topic] = Field(default_factory=list, max_length=100) 14 scores: list[Score] = Field(default_factory=list, max_length=100) 15 target: str = Field(default="列表", max_length=100) 16 pass_score: int = Field(default=60, ge=0, le=100) 17 18@app.post("/lists") 19async def lists(request: ListRequest) -> dict[str, object]: 20 report = build_report(request.topics, request.scores, request.target, request.pass_score) 21 print(f"通过的成绩:{report['scores']['passed']}") 22 print(f"append 与 extend:{report['append']} / {report['extend']}") 23 print(f"赋值共享:{report['alias']['same_object']};复制共享:{report['copy']['same_object']}") 24 return report 25
01def build_report( 02 topics: list[str], scores: list[int], target: str, pass_score: int 03) -> dict[str, object]: 04 cleaned = [topic.strip() for topic in topics if topic.strip()] 05 06 # 同样的参数,append 放入整个列表,extend 逐个追加元素。 07 appended = cleaned.copy() 08 appended.append(["函数", "模块"]) 09 extended = cleaned.copy() 10 extended.extend(["函数", "模块"]) 11 inserted = cleaned.copy() 12 inserted.insert(1, "函数") 13 14 removed = cleaned.copy() 15 if target in removed: 16 removed.remove(target) 17 popped = removed.pop() if removed else None 18 19 original = cleaned.copy() 20 alias = original 21 alias.append("函数") 22 copied_source = cleaned.copy() 23 copied = copied_source.copy() 24 copied.append("函数") 25 26 sorted_scores = scores.copy() 27 sorted_scores.sort() 28 return { 29 "original": topics.copy(), 30 "cleaned": cleaned, 31 "first": cleaned[0] if cleaned else None, 32 "slice": cleaned[:2], 33 "append": appended, 34 "extend": extended, 35 "insert": inserted, 36 "remove_and_pop": {"remaining": removed, "popped": popped}, 37 "lookup": { 38 "target": target, 39 "count": cleaned.count(target), 40 "index": cleaned.index(target) if target in cleaned else None, 41 }, 42 "enumerated": [{"number": index, "topic": topic} 43 for index, topic in enumerate(cleaned, start=1)], 44 "scores": { 45 "original": scores.copy(), 46 "sorted": sorted_scores, 47 "descending": sorted(scores, reverse=True), 48 "passed": [score for score in scores if score >= pass_score], 49 "sum": sum(scores), 50 "min": min(scores) if scores else None, 51 "max": max(scores) if scores else None, 52 }, 53 "alias": {"original": original, "alias": alias, "same_object": original is alias}, 54 "copy": {"original": copied_source, "copied": copied, 55 "same_object": copied_source is copied}, 56 } 57 58if __name__ == "__main__": 59 import json 60 61 print(json.dumps(build_report(["变量", "列表", "字符串"], [58, 76, 91, 42, 68], "列表", 60), 62 ensure_ascii=False, indent=2)) 63
打开本篇在线案例,点击运行并等待环境就绪。案例预览默认选择 POST,地址为:
1/lists
请求体已填好,可以直接发送:
01{ 02 "topics": [ 03 "变量", 04 "列表", 05 "字符串" 06 ], 07 "scores": [ 08 58, 09 76, 10 91, 11 42, 12 68 13 ], 14 "target": "列表", 15 "pass_score": 60 16}
默认响应中,append 的最后一项是嵌套列表 ["函数", "模块"],extend 的最后两项则是两个字符串。scores.passed 是 [76, 91, 68],sum 为 335。alias.same_object 为 true,copy.same_object 为 false。
append
["函数", "模块"]
extend
scores.passed
[76, 91, 68]
sum
335
alias.same_object
true
copy.same_object
false
日志会打印对应的关键操作结果。把 pass_score 改成 80,passed 就只剩 [91];把 target 改成不存在的主题,lookup.index 会是 null。将 topics 和 scores 都改成 [],可以观察空列表。修改 lists_demo.py 里追加的主题后,保存并重新运行。
pass_score
80
passed
[91]
target
lookup.index
null
topics
scores
[]
lists_demo.py
空成绩列表的 sum 为 0,min 和 max 为 null;空主题列表的 first、popped 与查找失败的 index 都为 null。本例将成绩限制在 0 到 100、每组最多 100 项,不满足字段约束时返回 HTTP 422。copy() 是浅复制;这里复制的原始元素是字符串,嵌套可变对象的深复制不是本案例的操作。same_object 来自 Python 的 is,JSON 本身不会保存对象引用关系。
本案例只使用标准库、FastAPI 与 Pydantic,不需要模型密钥。下载并解压 ZIP,进入项目目录后执行:
1uv run python lists_demo.py 2uv run fastapi dev main.py
第一条直接在终端打印实验结果;第二条启动 FastAPI。打开 http://127.0.0.1:8000/docs,选择 POST /lists,填写同样的参数即可发起请求。本机使用 Python 3.12,浏览器使用当前 Pyodide 版本,通过 HTTPX ASGITransport 执行接口,不启动电脑上的 8000 端口。
本篇的代码、日志、Git 配置与 PI Agent 对话使用独立工作区;同站 Python 依赖缓存可以复用。本机配置文件、忽略规则和 README 都包含在项目中,可以在文件目录里查看、编辑和下载。
此段落已有评论,按 Enter 查看评论及回复列表。
连接 GitHub 后查看和发表评论,也可在 GitHub 查看公开讨论。
1. 列表
列表用于按顺序保存多个值。课程主题、待处理任务、模型消息和接口返回的记录,都可以先放进列表中,再逐个读取或处理。
使用方括号创建列表,元素之间用逗号分隔:
列表可以保存不同类型的值,但实际项目中通常让同一个列表中的元素具有相近的含义:
也可以使用
list()把其他可遍历对象转换成列表:列表是可变对象。创建空列表后,可以通过方法逐步添加数据:
2. 访问
列表中的元素按照位置保存,索引从
0开始:如果索引超出范围,会抛出
IndexError。读取不确定长度的列表时,可以先使用len()判断:切片可以得到一部分元素,规则和字符串切片一样:开始位置包含,结束位置不包含:
in和not in用来判断元素是否存在:3. 修改
列表可以通过索引修改某个元素:
append()在列表末尾添加一个元素,extend()则把另一个可遍历对象中的元素逐个添加进去:append()会把参数作为一个整体放进去,extend()会展开参数中的元素。两者的结果不同,选择时要先明确自己想要哪一种结构。列表还可以使用
+拼接。它会按照顺序连接两个列表,并返回一个新的列表,不会修改原来的列表:+两边都必须是列表,不能直接把列表和一个单独的元素相加。需要把多个元素追加到原列表时,可以使用+=:可以简单地这样区分:
+生成新的列表,+=把右侧列表中的元素加入当前列表。insert(index, value)可以在指定位置插入元素:删除元素时,
remove()按值删除第一次出现的元素,pop()按索引删除并返回元素:如果列表中不存在要删除的值,
remove()会抛出ValueError;如果索引不存在,pop()会抛出IndexError。不确定数据是否存在时,先用in检查,或者捕获异常。clear()会删除列表中的所有元素,但保留列表对象本身:4. 查找
列表提供了几个常用的统计和查找方法:
len(list)count(value)index(value)min(list)max(list)sum(list)调用
index()前最好先确认元素存在,否则找不到值时会抛出ValueError:列表可以使用
sort()原地排序,也可以使用sorted()生成一个新的排序结果:sort()会直接改变原列表,sorted()不会改变原列表。只想查看排序结果、还需要保留原始顺序时,优先使用sorted()。字符串列表也可以按照字符串长度排序:
5. 遍历
for循环是处理列表中每个元素最常见的方式:如果需要同时使用下标,可以使用
enumerate():遍历时也可以配合条件语句完成筛选或统计:
如果只是根据一个简单条件生成新列表,可以使用列表推导式:
列表推导式只是
for循环的一种简写。刚开始学习时,可以先读懂普通循环,再使用推导式;如果条件和转换逻辑太复杂,普通循环通常更容易维护。6. 组合
列表经常与字典、循环和条件语句组合使用,保存一组结构相同的数据:
列表也可以嵌套列表,用来表达二维数据:
复制列表时要注意:直接赋值不会创建新列表,只是让两个变量指向同一个列表:
如果需要一个独立的列表,可以使用切片、
copy()或list():这些方式是浅复制。如果列表中还嵌套了其他列表,内部列表仍然可能被共享。初学阶段先记住:简单的一维列表可以用
copy(),复杂嵌套结构需要进一步了解深复制。下面的例子把带空格的课程名称清理后排序,展示列表在实际数据处理中的组合用法:
7. 在线列表实验
这个接口接收课程主题与成绩列表。实验分别复制原列表再执行操作,因此 append、extend、删除和排序不会互相干扰,也不会累积到下次请求。
7.1 完整案例代码
main.py 提供接口,lists_demo.py 执行实验。下面展示的代码与在线编辑器的初始文件来自同一份源码;修改编辑器中的文件后,保存并重新运行,接口就会使用修改后的内容。
7.2 运行与观察
打开本篇在线案例,点击运行并等待环境就绪。案例预览默认选择 POST,地址为:
请求体已填好,可以直接发送:
默认响应中,
append的最后一项是嵌套列表["函数", "模块"],extend的最后两项则是两个字符串。scores.passed是[76, 91, 68],sum为335。alias.same_object为true,copy.same_object为false。日志会打印对应的关键操作结果。把
pass_score改成80,passed就只剩[91];把target改成不存在的主题,lookup.index会是null。将topics和scores都改成[],可以观察空列表。修改lists_demo.py里追加的主题后,保存并重新运行。空成绩列表的 sum 为 0,min 和 max 为 null;空主题列表的 first、popped 与查找失败的 index 都为 null。本例将成绩限制在 0 到 100、每组最多 100 项,不满足字段约束时返回 HTTP 422。copy() 是浅复制;这里复制的原始元素是字符串,嵌套可变对象的深复制不是本案例的操作。same_object 来自 Python 的 is,JSON 本身不会保存对象引用关系。
7.3 在本机继续运行
本案例只使用标准库、FastAPI 与 Pydantic,不需要模型密钥。下载并解压 ZIP,进入项目目录后执行:
第一条直接在终端打印实验结果;第二条启动 FastAPI。打开 http://127.0.0.1:8000/docs,选择 POST /lists,填写同样的参数即可发起请求。本机使用 Python 3.12,浏览器使用当前 Pyodide 版本,通过 HTTPX ASGITransport 执行接口,不启动电脑上的 8000 端口。
本篇的代码、日志、Git 配置与 PI Agent 对话使用独立工作区;同站 Python 依赖缓存可以复用。本机配置文件、忽略规则和 README 都包含在项目中,可以在文件目录里查看、编辑和下载。