第 1 / 15 课 · 打开课程目录
MISSION 01 · 学生自学
Python 第一声
函数把结果交给舞台。这次你要做出:让机器人读出你写的启动信号。
先看看成品,再改编自己的填空版
基础完成版是已经跑通的示范项目,可以先看这一课的效果;填空版留给你补代码、改作品。两个项目都会在新标签页打开,教程留在这里。
首次打开项目?先确认登录
若项目链接先跳到登录页,登录后请回到本教程,再点一次上方项目按钮。登录页可能不会保留项目编号。要修改填空版,还需点击平台上的“改编”,在自己的副本里操作和保存。
查看平台操作帮助 →先看一次完整效果,再找到代码从哪儿来
- 打开基础完成版,试玩舞台。点击小绿旗,再点舞台中下方的“启动按钮”,看看文字、机器人和实验室发生了什么变化。
- 看看真正的 Python。点击编辑区顶部的“Python”标签,在左侧文件列表选中已有的
python1,找到first_signal()和它的return。现在只看,不修改。 - 找到生成积木的入口。点击顶部“代码”标签,在左侧积木分类选“Python”,找到“从 Python 代码生成积木”。等你在填空版写好 Python、点击编辑器上方紫色三角形“运行”并检查“输出”后,就在这里生成给 Scratch 调用的积木。
- 开始做自己的版本。打开填空版,登录后点击“改编”,在自己的副本里按下方任务补代码。生成积木后选中“启动按钮”角色,把
first_signal()接到“将 返回信息 设为”的值位置,再点绿旗和启动按钮验证。
先试玩:Python 真的能唤醒舞台吗?
打开基础完成版,点击小绿旗,再点击舞台中下方的启动按钮。
你应该看到:
显示文本显示一条启动信号。- 机器人从待机变成唤醒。
- 实验室切换到唤醒状态。
- 成功面板、信号脉冲和启动光环出现。
- 舞台朗读 Python 返回的那句话。
这一步先不用看代码。只要先确认一件事:
舞台不是自己随便变的,它是在等 Python 给它一个结果。
这到底是真 Python 吗?
是。
这不是把 Scratch 积木翻译成“看起来像 Python 的文字”。本课里的 first_signal() 是一个真实运行的 Python 函数。
当你点击启动按钮时,发生的是:
Scratch 点击按钮
-> 调用 Python 函数 first_signal()
-> Python return 一句文字
-> Scratch 把文字存进 返回信息
-> 舞台显示、朗读、切换状态
你今天写的核心代码,以后换到常规 Python 环境里也仍然是 Python 写法。只是现在我们先让 Scratch 帮你看见结果。
停一下想一想:
Scratch 像舞台和演员,Python 像后台给出的结果。第一节课先学会让后台说出第一句话。
打开填空版:先找到最关键的几行
现在打开填空版。如果平台先要求登录,登录后回到本教程重新点击“在线打开填空项目”;进入项目后先点“改编”,在自己的副本里找到类似代码:
def first_signal() -> str:
# TODO:返回一条能显示在 Scratch 舞台上的启动信号
return " "
__all__ = [""]
先别被 def、箭头、下划线吓到。第 1 课只需要抓住两个位置:
| 位置 | 你要做什么 | 为什么 |
|---|---|---|
return " " |
在引号里写一条启动信号 | 这句话会交给 Scratch |
__all__ = [""] |
写入 "first_signal" |
平台才知道要生成哪个 Python 积木 |
第一个关键动作:让 Python 说出一句话
把代码改成:
def first_signal() -> str:
return "Python 信号收到!代码伙伴小 Q 已上线。"
这里最重要的是 return。
return 的意思不是“在 Python 里显示一下”,而是:
把这个结果交出去。
在本课里,接收这个结果的是 Scratch。
第二个关键动作:让平台生成这个函数的积木
继续把下面一行改成:
__all__ = ["first_signal"]
你可以把 __all__ 暂时理解成一张名单:
名单里写了 first_signal
-> 平台就会把 first_signal 生成 Scratch 可调用的 Python 积木
第 1 课不需要深入研究 __all__ 的所有细节。先会用它,让项目跑起来。
完整代码应该像这样
检查你的代码是否接近下面这样:
def first_signal() -> str:
return "Python 信号收到!代码伙伴小 Q 已上线。"
__all__ = ["first_signal"]
如果你想先稳稳完成主线,建议这一轮不要改函数名 first_signal。
重新生成 Python 积木
改完 Python 后,先在 Python 编辑器上方点击紫色三角形“运行”,检查下方“输出”有没有报错。然后点击编辑区顶部“代码”标签,在左侧积木分类中点“Python”,最后点击积木区的“从 Python 代码生成积木”。确认 first_signal 积木出现。
这是很容易漏的一步。
你可以这样理解:
你刚刚改的是 Python 文件。
Scratch 要调用新代码,就需要平台重新生成一次对应积木。
如果忘了这一步,舞台可能还是旧效果,或者找不到你刚刚改好的函数。
回到舞台验证
Python 测试通过后,点击红色停止按钮;到“代码”标签 → 左侧“Python”分类 → 点击“从 Python 代码生成积木”。回到 Scratch,按下面的接线清单逐项核对。
接线清单:逐格核对填空版
填好 Python 并重新生成积木后,选中 启动按钮。在“当角色被点击”脚本里,找到“将 返回信息 设为”积木:把 first_signal() 放进它的值槽。填空版该槽是空的;完整版在同一位置已经接好。随后点击按钮,确认返回信息及舞台反馈更新。
运行检查
点击绿旗,再点击启动按钮。检查返回文字、朗读和机器人启动效果。
如果没成功,按这个顺序查
先别急着重写。按顺序检查:
- 文本有没有放在引号里?
return "Python 信号收到!"
- 函数名是不是仍然叫
first_signal?
def first_signal() -> str:
__all__是不是这样?
__all__ = ["first_signal"]
-
改完 Python 后有没有重新生成积木?
-
有没有重新点击小绿旗,再点击启动按钮?
卡住不代表不适合学 Python。第 1 课最常见的问题,几乎都来自引号、函数名、生成积木这几个小地方。
挑战:写一句属于你的启动信号
主线跑通后,可以把返回文本改成自己的版本。
例如:
return "任务档案 01 已解锁,我准备好了。"
或者:
return "小 Q 已收到 Python 信号,实验室启动!"
这一次不要改 Scratch。只改 Python,再重新生成积木并点击按钮。
你会发现:舞台不用重做,只要 Python 返回不同文字,作品就变成了你的版本。
本课复盘
本课你真正学会的是:
Python 负责返回结果。
Scratch 负责把结果显示、朗读并演出来。
这就是本课程和普通 Python 入门课不一样的地方:你不是只在控制台看见文字,而是在作品里看见 Python 产生效果。
本课回顾:
return不是把话留在 Python 里,而是把结果交出去。
