第 11 / 15 课 · 打开课程目录
MISSION 11 · 学生自学
僵尸小队名单管理
管理一组数据。这次你要做出:增删并展示小队成员。
先试玩基础完成版,再从填空版动手
基础完成版是已经跑通的示范项目,可以先看这一课的效果;填空版留给你补代码、改作品。两个项目都会在新标签页打开,教程留在这里。
首次打开项目?先确认登录
若项目链接先跳到登录页,登录后请回到本教程,再点一次上方项目按钮。登录页可能不会保留项目编号。要修改填空版,还需点击平台上的“改编”,在自己的副本里操作和保存。
查看平台操作帮助 →先试玩与认识名单
先别写代码,试玩一次
点击本页上方的“在线打开基础完成版”按钮,点击绿旗。
你应该看到 3 名初始队员:Zombie-Q、Byte、Nova。
按下面的顺序操作:
- 点击“加入队尾”,输入
Moss。 - 再次加入
Moss。 - 点击
Byte的队员卡,再点击“离队”。 - 继续添加,直到名单有 5 人。
- 尝试加入第 6 人。
- 再点一次绿旗。
边操作边观察三个地方:队员卡、队员数、状态消息。
你应该发现:成功操作会改变名单;重复名、空名字和满员只会给出提示,不会破坏名单;绿旗会恢复初始状态。
为什么要用列表
如果只保存一个名字,可以使用一个变量:
member = 'Zombie-Q'
但小队有很多成员,而且有先后顺序。列表可以把一组数据放在一起:
squad = ['Zombie-Q', 'Byte', 'Nova']
最外面的方括号 [] 表示列表。每个名字都是一个字符串,字符串之间用英文逗号分隔。
列表是一种组织数据的方式。游戏背包、好友列表、播放队列、购物清单和值日表,都可以用类似思路管理一组对象。
列表的位置和 Python 下标
我们平常说“第 1 个、第 2 个、第 3 个”,但 Python 下标从 0 开始:
日常位置:第1个 第2个 第3个
Python下标: 0 1 2
成员名字: Zombie-Q Byte Nova
因此:
squad[0] # Zombie-Q
squad[1] # Byte
squad[2] # Nova
Scratch 的列表位置从 1 开始。Scratch 传来第 position 个位置时,Python 要减 1:
return squad[position - 1]
你可以把下标理解成“元素离起点有几格”。第一个元素就在起点,所以距离是 0。
为什么初始名单要 .copy()
项目中会保留一份初始名单:
INITIAL_SQUAD = ['Zombie-Q', 'Byte', 'Nova']
squad = INITIAL_SQUAD.copy()
.copy() 会复制一份新列表。运行时修改 squad,不会污染 INITIAL_SQUAD。
如果直接写:
squad = INITIAL_SQUAD
两个变量可能指向同一个列表。修改当前名单时,初始名单也会一起变化,重置就可能失效。
它很像:一份是原始名单,一份是复印件。我们在复印件上修改,把原件留作恢复依据。
操作名单与接口
先清理用户输入
Scratch 询问框得到的内容会传给 Python:
name = str(name).strip()
这里连续做了两件事:
str(name):把输入统一转换成文字。.strip():删除文字开头和结尾的空格。
如果用户只输入空格,清理后会得到空字符串。这样程序就能把它识别成空名字,而不是把几个看不见的空格当作成员名。
用 append() 加入队尾
squad.append(name)
append 的意思是追加。它会把新元素放到列表末尾。
这行代码可以拆成三部分:
squad . append (name)
名单 执行追加 要加入的名字
点号前面是执行动作的对象,括号里是这个动作需要的数据。
只写下面这行不会真正执行:
squad.append
括号表示调用方法,name 表示要加入谁。因此正确写法必须是 squad.append(name)。
用 in 和 not in 判断成员
加入成员前要阻止重名:
if name not in squad:
squad.append(name)
name not in squad 读作:“name 不在 squad 中。”
in 和 not in 是判断运算符,不是函数,不要写成 not_in()。
下面两段代码意思相反:
if name in squad:
# 名字已经存在
if name not in squad:
# 名字还不存在
如果误写成“名字存在时再添加”,列表会出现重复名字。所以一定要先把条件翻译成人话,再写代码。
用 remove() 按名字删除
if name in squad:
squad.remove(name)
remove(name) 会找到内容等于 name 的元素并删除它。
本项目禁止重名,因此一个名字只对应一名队员。删除后,后面的成员会自动向前补位,列表中不会留下空洞。
为什么先判断 name in squad?因为删除一个不存在的名字会造成错误。先判断,程序就能返回友好状态,而不是突然停止。
注意:这里传入的是成员名字,不是第几个位置。
用 len() 得到队员数
len(squad)
len() 会返回列表里有多少个元素。
它和 append() 的写法不同:
squad.append(name) # 列表的方法:对象.方法(参数)
len(squad) # Python函数:函数(对象)
append() 属于列表,所以写在点号后面;len() 是 Python 提供的通用函数,所以把列表放进括号里。
基础版的 5 个 Python 接口
Python 不是只运行一次整段程序。Scratch 会在需要时调用不同函数:
| 函数 | 功能 |
|---|---|
reset_squad() |
恢复初始名单 |
add_member(name) |
尝试加入新成员 |
remove_member(name) |
尝试删除选中成员 |
get_member(position) |
读取指定位置的名字 |
get_member_count() |
读取当前人数 |
修改名单的函数会返回状态,例如:
added 加入成功
duplicate 名字重复
empty_name 名字为空
full 名单已满
removed 删除成功
not_found 没有找到该成员
Scratch 根据这些状态显示对应提示。
完成填空并测试
开始完成填空版
点击本页上方的“在线打开填空项目”按钮,进入 Python 标签页。
基础任务只有 3 个填空。先自己思考,再核对下面的提示。
填空 1:加入队尾
原代码:
squad.__________
思考:让哪个对象执行什么方法?方法需要接收谁?
答案:
squad.append(name)
填空 2:禁止重名
原代码:
if name _______ squad:
思考:名字在名单里时允许添加,还是不在名单里时允许添加?
答案:
if name not in squad:
填空 3:删除选中成员
原代码:
squad.__________
思考:按名字删除使用哪个列表方法?
答案:
squad.remove(name)
完成后先不要点绿旗,也不要急着生成积木。下一步是 Python 测试。
先运行 Python 测试
找到代码底部的测试部分,运行 Python。
你应该看到类似的中间过程:
初始化:['Zombie-Q', 'Byte', 'Nova']
加入 Moss 后:['Zombie-Q', 'Byte', 'Nova', 'Moss']
Byte 离队后:['Zombie-Q', 'Nova', 'Moss']
不要只检查“有没有报错”。请逐行回答:
- 初始名单是否正确?
- Moss 是否出现在队尾?
- Byte 是否真的被删除?
- 删除后其他成员的顺序是否正确?
中间打印很重要。如果第一步正确、第二步开始错误,你就知道问题出现在添加附近,不需要从头乱改。
Python 报错时怎么查
检查英文符号
代码中的括号、引号、逗号和冒号应使用英文符号。
检查括号和参数
squad.append(name)
squad.remove(name)
左右括号要成对,括号里不能漏掉 name。
检查 not in
两个单词之间有空格,顺序是 not in。
检查冒号和缩进
if 行末有冒号;属于 if 的下一行要向右缩进。
从第一条错误开始
一处符号错误可能引起后面很多提示。先修复系统指出的第一条错误,再重新运行,不要同时随意修改很多行。
接入 Scratch 并验收
Python 测试通过后,点击红色停止按钮;到“代码”标签 → 左侧“Python”分类 → 点击“从 Python 代码生成积木”。回到 Scratch,按下面的接线清单逐项核对。
接线清单:逐格核对填空版
选中 名单控制器。基础主线需补五个 Python 函数积木,分布在以下脚本;填空版原有的 Python 列表同步积木保留,不要删掉:
| 脚本 / 自制积木 | 空槽 | 拼入内容 |
|---|---|---|
| 小绿旗 | 将 操作结果 设为 |
reset_squad() |
| 接收“加入队尾” | 将 操作结果 设为 |
add_member(name=回答) |
| 接收“离队” | 将 操作结果 设为 |
remove_member(name=当前选中队员) |
| 名单刷新自制积木 | 将 队员数 设为 |
get_member_count() |
| 名单刷新自制积木 | 将 队长名 设为 |
get_member(position=1) |
同一角色还留有两条挑战注释:rename_member(old_name=当前选中队员, new_name=回答) 和 add_captain(name=当前选中队员)。它们是挑战版入口,基础主线不要求提前接入。
运行检查
五个函数槽和原有列表同步积木都核对后,再测初始名单、加入、重复加入、离队、满员和绿旗重置。
基础功能验收
请依次完成下面的测试,不要只测试一次正常添加。
- [ ] 绿旗后显示
Zombie-Q、Byte、Nova。 - [ ] 加入
Moss后,它出现在队尾,人数变为 4。 - [ ] 再加
Moss,名单不变并提示重复。 - [ ] 输入空格,名单不变并提示空名字。
- [ ] 点击
Byte卡片后离队,删除的是 Byte。 - [ ] 加满 5 人后,第 6 人被阻止。
- [ ] 再点绿旗,恢复 3 人初始名单。
操作删除前要先点击一张非空队员卡。卡片表示“对谁操作”,按钮表示“做什么操作”。
三层排错法
作品没反应时,不要马上重写代码。按顺序检查三层。
第一层:Python
- Python 能运行吗?
- 三行测试打印正确吗?
- 填空、英文符号、冒号和缩进正确吗?
第二层:对外接口
- 函数在
__all__中吗? - 修改后重新生成积木了吗?
- 生成前先停止 Scratch 了吗?
第三层:Scratch
- 积木接到“名单控制器”了吗?
- 积木是接在线路里,还是悬空?
- 参数接对了吗?
- 点击绿旗初始化了吗?
- 删除前先选中队员了吗?
一次只检查一层,你会更快找到真正原因。
综合挑战:队长与改名
开始综合挑战
挑战从基础完成版继续,只升级 Python 功能,不重新设计 Scratch 操作流程。
最终要实现:
- 点击队员卡,再点“设为队长”,该成员移动到队首。
- 点击队员卡,再点“改名”,新名字留在原来的位置。
先认识 # 和三引号
单行注释使用 #:
# 从井号开始到这一行结尾,Python 不执行
项目中还用成对三引号暂时包住挑战代码:
'''
这里的多行内容暂时不参与运行
'''
三引号必须成对。挑战代码看得到却不能运行时,检查它是否仍被三引号包住。
严格来说,三引号创建的是多行字符串。本项目把独立放置的三引号区域当作“暂时关闭多行代码”的方法。它和 # 不是完全相同的语法。
取消挑战区时,先找到开始和结束两个三引号,再准确删除。少删或多删都可能让大片代码失效。
挑战一部分:设为队长
设为队长的本质是:把选中成员从原位置移动到第 1 位。
squad.remove(name)
squad.insert(0, name)
第一行先删除原位置的成员;第二行把它插入下标 0,也就是队首。
为什么不能只使用 insert(0, name)?因为原位置的成员仍然存在,名单会出现两个同名成员。
为什么先删后插?如果先插入,remove(name) 可能先删掉刚插入队首的那个名字,移动就会失败。
挑战另一部分:原位置改名
改名不能简单地“删除旧名字,再把新名字加入队尾”,否则成员位置会变化。
先找旧名字的位置:
position = squad.index(old_name)
再修改这个位置:
squad[position] = new_name
还要阻止重复新名字:
if new_name in squad:
return 'duplicate'
index() 返回 Python 下标。下标赋值只替换该位置的内容,不会改变其他成员的顺序。
开放挑战接口
完成 add_captain() 和 rename_member() 后,在 __all__ 中开放它们:
'add_captain',
'rename_member',
同时取消挑战测试区的注释,运行 Python 测试。
正确的中间过程应包括:
初始化:['Zombie-Q', 'Byte', 'Nova']
加入 Moss 后:['Zombie-Q', 'Byte', 'Nova', 'Moss']
Byte 离队后:['Zombie-Q', 'Nova', 'Moss']
Moss 成为队长后:['Moss', 'Zombie-Q', 'Nova']
Nova 改名后:['Moss', 'Zombie-Q', 'star']
确认无误后,再重复标准流程:停止 Scratch、生成积木、把两个挑战积木接入名单控制器的预留槽位、点击绿旗验证。
挑战验收
- [ ] 选中非队首成员后,可以移动到第 1 格。
- [ ] 队长名和队长徽章同步刷新。
- [ ] 改名后成员仍留在原位置。
- [ ] 新名字重复时,名单不变。
- [ ] 新名字为空或只有空格时,名单不变。
- [ ] 没有选中成员时,不会误操作其他队员。
- [ ] 绿旗可以恢复初始名单。
解释做出的系统
你真正做出的系统
Python 中的 squad 是真实名单。Scratch 列表和队员卡是它的显示结果。
如果 Python 测试正确,但卡片没有更新,问题可能在接口或 Scratch 刷新;如果卡片看起来正常,但 Python 测试错误,画面也可能只是旧结果。
把数据、接口和界面分开检查,是非常实用的项目调试方法。
想一想
- 为什么加入成员用
append(),设置队长却用insert(0, ...)? - 为什么基础版禁止重名后,按名字删除会更可靠?
- 为什么改名要先用
index()记住位置? - 如果 Python 测试通过但画面没变,你先查哪一层?
- 你还能想到哪些需要“添加、删除、查找、排序”的列表系统?
本课回顾
程序不只处理一个东西,也能管理一整队。
