feat(python基础): 新增列表教学课程
This commit is contained in:
zhiye.sun
489
01_python基础/1_8_列表/README.md
Normal file
489
01_python基础/1_8_列表/README.md
Normal file
@@ -0,0 +1,489 @@
|
||||
# 第 1-8 课：列表
|
||||
|
||||
## 一、本课目标
|
||||
|
||||
完成本课后，你应该能够：
|
||||
|
||||
1. 解释列表为什么可以保存多个数据；
|
||||
2. 创建列表和空列表；
|
||||
3. 使用索引、负索引和切片读取列表；
|
||||
4. 修改列表中的指定元素；
|
||||
5. 添加和删除列表元素；
|
||||
6. 查找并统计列表中的元素；
|
||||
7. 对列表进行排序和反转；
|
||||
8. 使用循环遍历列表；
|
||||
9. 在确实需要位置时使用索引遍历；
|
||||
10. 理解列表可变性；
|
||||
11. 区分直接赋值与列表复制；
|
||||
12. 看懂简单的二维列表。
|
||||
|
||||
## 二、前置知识
|
||||
|
||||
开始本课前，你应该已经掌握：
|
||||
|
||||
- 变量和基础数据类型；
|
||||
- 字符串的索引与切片；
|
||||
- `if` 条件判断；
|
||||
- `for` 循环；
|
||||
- `in` 成员判断；
|
||||
- 字符串的 `split()` 和 `join()`。
|
||||
|
||||
## 三、为什么需要列表
|
||||
|
||||
如果要保存多个 Agent 开发工具，可以分别创建变量：
|
||||
|
||||
```python
|
||||
tool_1 = "Python"
|
||||
tool_2 = "FastAPI"
|
||||
tool_3 = "Django"
|
||||
```
|
||||
|
||||
数据增加后，这种方式难以统一遍历、排序和管理。
|
||||
|
||||
列表（List）可以使用一个变量保存多个有顺序的数据：
|
||||
|
||||
```python
|
||||
agent_tools = ["Python", "FastAPI", "Django"]
|
||||
```
|
||||
|
||||
列表使用英文方括号 `[]`，元素之间使用英文逗号分隔。
|
||||
|
||||
## 四、创建列表
|
||||
|
||||
### 4.1 创建包含数据的列表
|
||||
|
||||
```python
|
||||
agent_tools = ["Python", "FastAPI", "Django"]
|
||||
```
|
||||
|
||||
### 4.2 创建空列表
|
||||
|
||||
```python
|
||||
agent_tools = []
|
||||
```
|
||||
|
||||
空列表暂时没有元素，但后续可以添加数据。
|
||||
|
||||
### 4.3 列表可以保存不同类型
|
||||
|
||||
```python
|
||||
learning_record = ["Python", 8, 2.5, True]
|
||||
```
|
||||
|
||||
Python 允许一个列表保存不同类型的数据。不过实际开发中，同一个列表通常保存含义相近的数据，这样更容易理解和处理。
|
||||
|
||||
## 五、列表是有顺序的
|
||||
|
||||
列表中的每个元素都有位置，索引从 `0` 开始：
|
||||
|
||||
```text
|
||||
元素： Python FastAPI Django
|
||||
正索引： 0 1 2
|
||||
负索引： -3 -2 -1
|
||||
```
|
||||
|
||||
读取元素：
|
||||
|
||||
```python
|
||||
agent_tools = ["Python", "FastAPI", "Django"]
|
||||
|
||||
print(agent_tools[0])
|
||||
print(agent_tools[-1])
|
||||
```
|
||||
|
||||
输出：
|
||||
|
||||
```text
|
||||
Python
|
||||
Django
|
||||
```
|
||||
|
||||
如果访问不存在的索引，会产生 `IndexError`。
|
||||
|
||||
## 六、列表切片
|
||||
|
||||
列表切片与字符串切片规则相同：包含开始索引，不包含结束索引。
|
||||
|
||||
```python
|
||||
agent_tools = ["Python", "FastAPI", "Django", "LangChain"]
|
||||
|
||||
print(agent_tools[0:2])
|
||||
print(agent_tools[:3])
|
||||
print(agent_tools[2:])
|
||||
print(agent_tools[::-1])
|
||||
```
|
||||
|
||||
切片返回一个新列表，不会直接修改原列表。
|
||||
|
||||
## 七、列表长度
|
||||
|
||||
使用 `len()` 获取元素数量：
|
||||
|
||||
```python
|
||||
agent_tools = ["Python", "FastAPI", "Django"]
|
||||
tool_count = len(agent_tools)
|
||||
|
||||
print(tool_count)
|
||||
```
|
||||
|
||||
输出为 `3`。
|
||||
|
||||
访问首尾元素前，可以先判断列表是否非空：
|
||||
|
||||
```python
|
||||
if agent_tools:
|
||||
print(agent_tools[0])
|
||||
print(agent_tools[-1])
|
||||
else:
|
||||
print("工具列表为空")
|
||||
```
|
||||
|
||||
空列表在条件中会被当作 `False`。
|
||||
|
||||
## 八、列表是可变的
|
||||
|
||||
字符串不可变，但列表是可变的（Mutable），可以直接修改某个位置的元素：
|
||||
|
||||
```python
|
||||
agent_tools = ["Python", "Flask", "Django"]
|
||||
agent_tools[1] = "FastAPI"
|
||||
|
||||
print(agent_tools)
|
||||
```
|
||||
|
||||
输出：
|
||||
|
||||
```text
|
||||
['Python', 'FastAPI', 'Django']
|
||||
```
|
||||
|
||||
必须确保索引存在，不能通过一个超出范围的索引直接添加元素。
|
||||
|
||||
## 九、添加元素
|
||||
|
||||
### 9.1 `append()` 追加到末尾
|
||||
|
||||
```python
|
||||
agent_tools = ["Python", "FastAPI"]
|
||||
agent_tools.append("Django")
|
||||
```
|
||||
|
||||
`append()` 每次把一个元素添加到列表末尾。
|
||||
|
||||
### 9.2 `insert()` 插入指定位置
|
||||
|
||||
```python
|
||||
agent_tools.insert(1, "Pydantic")
|
||||
```
|
||||
|
||||
第一个参数是插入索引，第二个参数是新元素。原来位于该位置及后面的元素会向后移动。
|
||||
|
||||
### 9.3 `extend()` 添加多个元素
|
||||
|
||||
```python
|
||||
agent_tools.extend(["LangChain", "OpenAI SDK"])
|
||||
```
|
||||
|
||||
`extend()` 会依次加入另一个列表中的元素。
|
||||
|
||||
请比较：
|
||||
|
||||
```python
|
||||
agent_tools.append(["LangChain", "OpenAI SDK"])
|
||||
```
|
||||
|
||||
`append()` 会把整个列表当作一个元素加入，形成嵌套列表；`extend()` 才是逐个加入多个元素。
|
||||
|
||||
## 十、删除元素
|
||||
|
||||
### 10.1 `remove()` 按内容删除
|
||||
|
||||
```python
|
||||
agent_tools.remove("Django")
|
||||
```
|
||||
|
||||
`remove()` 删除第一个匹配的元素。如果元素不存在，会产生 `ValueError`。
|
||||
|
||||
安全写法：
|
||||
|
||||
```python
|
||||
if "Django" in agent_tools:
|
||||
agent_tools.remove("Django")
|
||||
```
|
||||
|
||||
### 10.2 `pop()` 按位置删除并返回元素
|
||||
|
||||
```python
|
||||
removed_tool = agent_tools.pop()
|
||||
```
|
||||
|
||||
不传索引时删除最后一个元素，并把被删除的数据返回。
|
||||
|
||||
```python
|
||||
removed_tool = agent_tools.pop(1)
|
||||
```
|
||||
|
||||
传入索引时删除指定位置。
|
||||
|
||||
### 10.3 `del` 删除指定位置
|
||||
|
||||
```python
|
||||
del agent_tools[0]
|
||||
```
|
||||
|
||||
`del` 是 Python 关键字，不会返回被删除的数据。
|
||||
|
||||
### 10.4 `clear()` 清空列表
|
||||
|
||||
```python
|
||||
agent_tools.clear()
|
||||
```
|
||||
|
||||
执行后列表仍然存在，但元素数量变为 `0`。
|
||||
|
||||
## 十一、查找和统计
|
||||
|
||||
### 11.1 使用 `in`
|
||||
|
||||
```python
|
||||
contains_fastapi = "FastAPI" in agent_tools
|
||||
```
|
||||
|
||||
### 11.2 `index()` 查找位置
|
||||
|
||||
```python
|
||||
if "FastAPI" in agent_tools:
|
||||
fastapi_index = agent_tools.index("FastAPI")
|
||||
```
|
||||
|
||||
找不到时，`index()` 会产生 `ValueError`，因此可以先使用 `in`。
|
||||
|
||||
### 11.3 `count()` 统计次数
|
||||
|
||||
```python
|
||||
python_count = agent_tools.count("Python")
|
||||
```
|
||||
|
||||
找不到时返回 `0`，不会报错。
|
||||
|
||||
## 十二、排序和反转
|
||||
|
||||
### 12.1 `sort()` 修改原列表
|
||||
|
||||
```python
|
||||
scores = [80, 95, 70, 88]
|
||||
scores.sort()
|
||||
print(scores)
|
||||
```
|
||||
|
||||
默认从小到大排序。
|
||||
|
||||
降序排列：
|
||||
|
||||
```python
|
||||
scores.sort(reverse=True)
|
||||
```
|
||||
|
||||
英文字符串通常按照字符编码顺序排序，大小写可能影响结果。
|
||||
|
||||
### 12.2 `reverse()` 反转当前顺序
|
||||
|
||||
```python
|
||||
agent_tools.reverse()
|
||||
```
|
||||
|
||||
`reverse()` 只把当前顺序倒过来，并不按大小重新排序。
|
||||
|
||||
### 12.3 `sorted()` 返回新列表
|
||||
|
||||
```python
|
||||
original_scores = [80, 95, 70]
|
||||
sorted_scores = sorted(original_scores)
|
||||
```
|
||||
|
||||
`sorted()` 返回排序后的新列表，原列表保持不变。
|
||||
|
||||
## 十三、遍历列表
|
||||
|
||||
### 13.1 直接遍历元素
|
||||
|
||||
```python
|
||||
for tool in agent_tools:
|
||||
print(tool)
|
||||
```
|
||||
|
||||
只需要元素时，优先直接遍历，代码最清晰。
|
||||
|
||||
### 13.2 需要索引时使用 `range(len(...))`
|
||||
|
||||
```python
|
||||
for index in range(len(agent_tools)):
|
||||
print(f"{index + 1}. {agent_tools[index]}")
|
||||
```
|
||||
|
||||
只有确实需要修改指定位置或使用索引时，才采用这种方式。
|
||||
|
||||
### 13.3 使用 `enumerate()` 同时取得编号和元素
|
||||
|
||||
```python
|
||||
for number, tool in enumerate(agent_tools, start=1):
|
||||
print(f"{number}. {tool}")
|
||||
```
|
||||
|
||||
`enumerate()` 会同时提供编号和元素，通常比 `range(len(...))` 更易读。
|
||||
|
||||
本课先学会模仿这种常用写法，函数返回多个数据的原理会在后续课程继续讲解。
|
||||
|
||||
## 十四、简单二维列表
|
||||
|
||||
列表中的元素也可以是列表：
|
||||
|
||||
```python
|
||||
tool_records = [
|
||||
["Python", "基础编程"],
|
||||
["FastAPI", "接口开发"],
|
||||
["Django", "Web 应用"],
|
||||
]
|
||||
```
|
||||
|
||||
读取 FastAPI 的用途：
|
||||
|
||||
```python
|
||||
print(tool_records[1][1])
|
||||
```
|
||||
|
||||
第一个索引选择第二条记录，第二个索引选择该记录中的第二个元素。
|
||||
|
||||
二维列表适合简单表格数据，但真实业务数据常使用字典、对象或数据库表达，将在后续课程学习。
|
||||
|
||||
## 十五、直接赋值与复制
|
||||
|
||||
### 15.1 直接赋值不会创建独立列表
|
||||
|
||||
```python
|
||||
original_tools = ["Python", "FastAPI"]
|
||||
backup_tools = original_tools
|
||||
|
||||
backup_tools.append("Django")
|
||||
|
||||
print(original_tools)
|
||||
print(backup_tools)
|
||||
```
|
||||
|
||||
两个变量都会看到 `Django`，因为它们指向同一个列表对象。
|
||||
|
||||
### 15.2 使用 `copy()` 创建浅复制
|
||||
|
||||
```python
|
||||
original_tools = ["Python", "FastAPI"]
|
||||
backup_tools = original_tools.copy()
|
||||
|
||||
backup_tools.append("Django")
|
||||
```
|
||||
|
||||
对于本课这种只包含字符串的简单列表，修改副本不会影响原列表。
|
||||
|
||||
`copy()` 创建的是浅复制（Shallow Copy）。嵌套列表中的共享问题属于进阶内容，本课暂不展开。
|
||||
|
||||
## 十六、方法返回值的常见误区
|
||||
|
||||
下面写法是错误思路：
|
||||
|
||||
```python
|
||||
agent_tools = ["Python", "FastAPI"]
|
||||
result = agent_tools.append("Django")
|
||||
print(result)
|
||||
```
|
||||
|
||||
输出为 `None`。`append()`、`sort()`、`reverse()` 等方法直接修改原列表，通常不返回修改后的列表。
|
||||
|
||||
正确观察方式：
|
||||
|
||||
```python
|
||||
agent_tools.append("Django")
|
||||
print(agent_tools)
|
||||
```
|
||||
|
||||
## 十七、运行本课示例
|
||||
|
||||
在 PowerShell 中执行：
|
||||
|
||||
```powershell
|
||||
cd D:\Code\Python\01_python基础\1_8_列表
|
||||
python lists.py
|
||||
```
|
||||
|
||||
示例无需用户输入，会依次展示创建、读取、修改、增删、查询、排序、遍历、二维列表和复制行为。
|
||||
|
||||
## 十八、常见错误
|
||||
|
||||
### 18.1 索引越界
|
||||
|
||||
访问不存在的位置会产生 `IndexError`。访问首尾元素前应确认列表非空。
|
||||
|
||||
### 18.2 删除不存在的元素
|
||||
|
||||
`remove()` 删除不存在的值会产生 `ValueError`，可以先使用 `in` 判断。
|
||||
|
||||
### 18.3 混淆 `append()` 与 `extend()`
|
||||
|
||||
- `append()` 添加一个元素；
|
||||
- `extend()` 依次添加多个元素。
|
||||
|
||||
### 18.4 把排序结果赋值回列表
|
||||
|
||||
```python
|
||||
agent_tools = agent_tools.sort()
|
||||
```
|
||||
|
||||
这会让 `agent_tools` 变成 `None`。应先调用，再读取原列表。
|
||||
|
||||
### 18.5 直接赋值误以为完成复制
|
||||
|
||||
`backup = original` 只是增加另一个变量名，并未创建独立列表。
|
||||
|
||||
## 十九、课堂练习
|
||||
|
||||
打开 `practice.py`，完成“Agent 工具清单管理器”。
|
||||
|
||||
运行命令：
|
||||
|
||||
```powershell
|
||||
python practice.py
|
||||
```
|
||||
|
||||
练习会要求你完成列表的创建、修改、添加、删除、查询、排序、遍历和复制。
|
||||
|
||||
## 二十、思考题
|
||||
|
||||
1. 列表和字符串在可变性方面有什么区别？
|
||||
2. `append()` 与 `extend()` 有什么区别？
|
||||
3. `remove()` 与 `pop()` 有什么区别？
|
||||
4. `sort()` 与 `sorted()` 对原列表的影响有什么不同？
|
||||
5. 为什么访问列表首项前要检查列表是否为空？
|
||||
6. 为什么 `backup = original` 不能得到独立副本？
|
||||
7. 只需要元素时，为什么优先直接遍历列表？
|
||||
|
||||
## 二十一、本课小结
|
||||
|
||||
- 列表可以保存多个有顺序的数据；
|
||||
- 列表索引从 `0` 开始，也支持负索引和切片；
|
||||
- 列表是可变对象，可以直接修改元素；
|
||||
- `append()`、`insert()`、`extend()` 用于添加；
|
||||
- `remove()`、`pop()`、`del`、`clear()` 用于删除；
|
||||
- `index()` 和 `count()` 用于查找统计；
|
||||
- `sort()` 修改原列表，`sorted()` 返回新列表；
|
||||
- `for` 和 `enumerate()` 可以遍历列表；
|
||||
- 直接赋值不会创建独立副本，简单列表可使用 `copy()`。
|
||||
|
||||
## 二十二、验收标准
|
||||
|
||||
- [ ] 能创建列表和空列表；
|
||||
- [ ] 能使用索引和切片读取列表；
|
||||
- [ ] 能修改、添加和删除元素；
|
||||
- [ ] 能安全查找指定元素；
|
||||
- [ ] 能排序并遍历列表；
|
||||
- [ ] 能解释列表可变性；
|
||||
- [ ] 能区分直接赋值与 `copy()`；
|
||||
- [ ] 能完成并运行 `practice.py`；
|
||||
- [ ] 能回答七道思考题。
|
||||
Reference in New Issue
Block a user