用积木做一个
能对弈的五子棋
学生第一次遇到"游戏需要记住状态"的问题:棋盘上的每一颗子,都得被程序记住。 这份讲义用五子棋把列表、双重循环、坐标换算、方向扫描串成一条完整的工程链—— 从点一下鼠标,到屏幕上多出一颗子,再到程序喊出"黑棋获胜"。
00课程总览
先说清楚"学完能做什么",再拆成可验收的小目标——这是所有工程项目的第一课。
学完这节课,学生能做到
| 维度 | 具体表现(可观察、可验收) |
|---|---|
| 知识 | 解释"列表 = 带编号的储物柜";说出 索引 = 行 × 15 + 列 + 1 里每个数字的含义;说明为什么判定要从落点向四个方向扫。 |
| 技能 | 独立用鼠标坐标换算出格点坐标并落子;用"列表第几项"读取/替换棋盘;用双重循环 + 标志变量实现"最多数 4 格,遇到空就停"。 |
| 素养 | 能把一个大问题("做个五子棋")拆成 5 个子问题;能用"打印/监视变量"定位 bug,而不是盲目改积木。 |
点一下鼠标 → 坐标换算成 (行, 列) → 换算成列表索引 → 写入列表(程序记住了)→ 广播让"棋子"角色画出这颗子 → 以落点为中心四方向扫描 → 数到 5 个同色就宣告胜利。
为什么用五子棋做项目
它逼你面对"状态"
打地鼠不需要记忆,五子棋必须记住 225 个格子的历史。这是从"动画"跨到"程序"的分水岭。
它有天然的二维数据
15×15 的棋盘正好讲"二维压成一维"——同一套索引公式,未来做扫雷、俄罗斯方块、地图都能用。
它的算法短而完整
判定逻辑只有 4 个方向 × 2 个方向 = 8 次扫描,却是真实的"游戏 AI 判定"雏形。
它有胜负,学生上瘾
做完就能和同桌对弈,"能玩"是最好的验收标准,也是最好的学习动机。
打开模板「五子棋对弈」直接跑给学生看:点几下,黑棋连成五子,程序弹出"⚫ 黑棋连成五子,获胜!"。 然后关掉运行,点开"代码"面板——一句句 Python 就是刚跑的积木。先给震撼,再拆零件。
01第一课时 · 让棋盘"记住"棋子
本课时只解决一件事:把屏幕上看得见的棋盘,变成程序里存得住的数据。
1.1 先拆需求,再动手
直接说"做个五子棋"学生会懵。把它写成 5 行需求,每行对应一个技术手段——这张表就是整个项目的施工图:
| # | 要做的事 | 技术手段 | 用到的积木 |
|---|---|---|---|
| 1 | 记住每个格子是空 / 黑 / 白 | 一个 225 项的列表 | 列表 替换列表项 |
| 2 | 知道玩家点了哪一格 | 鼠标坐标 → 四舍五入 → 行列 | 鼠标 x 坐标 四舍五入 |
| 3 | 屏幕上多出一颗子 | 广播 → 设造型 → 移到 → 克隆 | 广播并等待 克隆自己 |
| 4 | 判断是否五连 | 以落点为中心,四方向扫描 | 重复 4 次 列表第几项 |
| 5 | 宣布胜负、切换下一方 | 广播 + 变量 3 − 玩家 | 说 播放声音 |
只给第 1、2 列,让学生讨论"这件事程序要怎么做"。写不出来没关系,留空——等做完 2.2 再回头补,前后呼应。
1.2 棋盘 = 一个 225 项的列表
把棋盘想成一个 15 行 × 15 列 的储物柜,每个格子里放一个数字:
| 值 | 含义 | 屏幕上 |
|---|---|---|
| 0 | 这格是空的 | 什么都没有 |
| 1 | 黑子,或者"轮到黑棋" | 一颗黑子 |
| 2 | 白子,或者"轮到白棋" | 一颗白子 |
程序只需要一个列表就能装下整盘棋:棋盘 = [0, 0, 0, … 共 225 个]。
变量只能存一个值,列表能存一整张表——这就是列表存在的理由。
积木星球的列表和 Python 的列表不一样:积木里「第 1 项」是第一项(跟我们数数一致),
Python 里 board[0] 才是第一项。讲义里所有公式都按积木的从 1 开始写;
看代码面板时记住"差 1",附录 A 有一张对照表专门讲这个坑。
1.3 坐标换算:鼠标点在哪一格
舞台中心是 (0, 0),x 向右为正、y 向上为正。我们的棋盘格距 22,从 −154 到 +154 正好 15 个格点:
把公式写进积木,就四块:
将 列 设为 四舍五入( ( 鼠标 x 坐标 + 154 ) ÷ 22 ) 将 行 设为 四舍五入( ( 154 − 鼠标 y 坐标 ) ÷ 22 )
格点是离散的 15 个点,鼠标落在格点之间(比如两线中间)时,四舍五入会自动吸附到最近的那个交叉点—— 手感最像真实棋盘。取整会产生"偏左半格永远点不上"的问题。
不碰电脑,用公式算出下列鼠标坐标对应哪一格,填表后交换检查:
| 鼠标坐标 | 列 | 行 | 鼠标坐标 | 列 | 行 |
|---|---|---|---|---|---|
| (0, 0) | ? | ? | (−154, 154) | ? | ? |
| (88, 0) | ? | ? | (154, −154) | ? | ? |
答案:列 7/行 7 | 列 11/行 7 | 列 0/行 0 | 列 14/行 14
1.4 索引公式:二维压成一维
列表只有一根"长抽屉",而棋盘是二维的。所以要把 (行, 列) 压成一个编号:
记住这句口诀就更不会错:「先跳过前面 7 整行,再走 9 格,最后加 1 开始数」。
1.5 动手:把 225 个 0 装进列表
点右上角「属性 → 列表 → 新建列表」,建一个叫 棋盘 的空列表。然后用循环填满它:
当 🏁 被点击 删除 棋盘 的全部项目 # 开局先清空 重复 225 次 # 15 × 15 = 225 个格子 将 0 加入 棋盘 # 每一格先都是"空" 将 玩家 设为 1 # 1 = 黑棋先行 将 胜者 设为 0
点运行 → 打开底部「变量监视」→ 应该看到 棋盘(列表 · 225 项) 后面一串 0 0 0 0 …。
数字不对就是循环次数写错了;一项都没有就是「删除/加入」的列表选错了。
- 把 重复 225 次 改成 重复 15 次,运行后列表几项?为什么?
- 改成 重复 15 次 里再套一个 重复 15 次,结果一样吗?哪个写法更能说明"15 行 × 15 列"?
- 把「加入 0」改成「加入 行」,观察列表内容——你发现了什么?(提示:循环没有"当前第几次"的概念,得自己加计数器变量)
学生很快会发现"循环不知道自己是第几圈"。这个痛点正是第二课时「前进」变量存在的原因—— 先让他们撞墙,再给工具,接受度完全不同。
02第二课时 · 落子、画子、判胜负
这一课时把"点击"变成"一颗子 + 一次判定"。算法不难,难在顺序——顺序错了,判定就会用旧数据。
2.1 落子要过四道关
玩家的每一次点击,程序都要先审一遍再执行。这叫合法性检查,是所有游戏的基本功:
| 关 | 检查什么 | 条件(积木) | 不通过怎么办 |
|---|---|---|---|
| 1 | 游戏是不是已经结束 | 胜者 > 0 | 直接 停止这个脚本,什么都不做 |
| 2 | 棋盘是否已初始化 | 棋盘 的长度 < 225 | |
| 3 | 点的是不是棋盘范围内 | 不成立( 行、列 都在 0–14 之间 ) | 同上(点了棋盘外面) |
| 4 | 这一格是不是空的 | 棋盘 的第 索引 项 = 0 | 不落子,就是"这里已经有子了" |
积木没有「并且」加「或者」连成一长串的简洁写法,四条件与起来会拼出很大的积木块。 换个思路:先算"在范围内"这个条件,再取反——不成立( 行>−1 与 行<15 与 列>−1 与 列<15 ), 一个"不成立"就同时管住了越界的所有情况。
四道关都过了,才真正落子。注意这 4 行的顺序不能颠倒:
# ① 写入棋盘(程序"记住"了) 将 棋盘 的第 索引 项替换为 玩家 # ② 让棋子角色把这颗子画出来(等人画完再往下) 广播 "落子" 并等待 # ③ 判定胜负(用刚写入的新棋盘) 广播 "检查胜负" 并等待 # ④ 换人:1→2,2→1 (3 − 1 = 2) 将 玩家 设为 3 − 玩家
不用写"如果 玩家=1 那么设为 2,否则设为 1"两个分支。因为只有 1 和 2 两个值,3−1=2、3−2=1。
这种"用算术代替判断"的技巧叫状态翻转,学生学会一次能记一辈子。
2.2 把子画出来:广播 + 克隆
难点来了:积木不能跨角色操作。「棋盘」角色算出了行列,却不能直接命令「棋子」角色移动。 标准解法是广播——把结果放进全局变量,喊一声,让棋子角色自己来取:
棋盘上已经有 6 颗子时,再一次广播,7 个角色(1 个本体 + 6 个克隆体)都会执行落子脚本—— 克隆体再生克隆体,一秒钟就能炸出几百个。
解法是在落子脚本最前面加一句:如果「我是克隆体?」那么 停止这个脚本。 本体负责画新子,克隆体只管好好待在原地。运行日志里能看到"广播:落子(7 个接收方)"这样的记录,正好用来讲这件事。
2.3 判胜负:以落点为中心的四个方向
五连只可能经过刚下的那一颗子——所以不用扫全盘,只从落点出发看四个方向就够了:
方向不必写死 8 段积木。用两个小列表存起来,循环取值更简洁:
方向X = [ 1, 0, 1, 1 ] # 横、竖、正斜、反斜 方向Y = [ 0, 1, 1, −1 ] 重复 4 次 将 dx 设为 方向X 的第 方向号 项 将 dy 设为 方向Y 的第 方向号 项 # …… 沿 (dx,dy) 数一遍,再沿 (−dx,−dy) 数一遍 将 方向号 增加 1
"正斜"和"反斜"其实是一条对角线的两个朝向。取 dy=−1 就是往右上/左下走。 正反两个朝向都数,同一条对角线才会被完整数一遍,而且不重复。
2.4 单向扫描:用「断了吗」当刹车
从落点往一个方向最多只需要看 4 格(才能凑够 5)。但路上可能碰到空位、碰到对方的子、或者走出棋盘——必须停下来。
问题:积木的「重复」没有 break,怎么办?
加一个标志变量 断了吗,每次循环先问它:
完整的一段(正方向)长这样,反方向把 + 换成 − 复制一份即可:
将 前进 设为 1 将 断了吗 设为 0 重复 4 次 如果 断了吗 = 0 那么 将 临时行 设为 行 + dy × 前进 将 临时列 设为 列 + dx × 前进 如果 ( 临时行 在 0–14 与 临时列 在 0–14 ) 与 ( 棋盘 的第 (临时行×15+临时列+1) 项 = 玩家 ) 那么 将 连数 增加 1 否则 将 断了吗 设为 1 将 前进 增加 1
- 忘了外层的「如果 断了吗 = 0」:断掉之后还在继续加
连数,会把隔着空位的子也算成连在一起。 - 忘了「前进 +1」:四圈都在看同一格,连数直接变 5,误判获胜。
- 反方向忘了重置
前进和断了吗:反方向只数一格就停,漏判。
2.5 宣布胜负,并把子交出去
八个方向扫完,只要 连数 > 4(也就是 ≥ 5),记下胜者并广播:
如果 连数 > 4 那么 将 胜者 设为 玩家 # 四个方向都扫完以后 如果 胜者 > 0 那么 广播 "游戏结束" 并等待
当收到 "游戏结束" 播放声音 "胜利" 如果 胜者 = 1 那么 说 "⚫ 黑棋连成五子,获胜!" 3 秒 否则 说 "⚪ 白棋连成五子,获胜!" 3 秒
两人一组,用下面的顺序落子,必须在第 9 步看到黑棋获胜:
黑(7,7) → 白(0,0) → 黑(7,8) → 白(0,1) → 黑(7,9) → 白(0,2) → 黑(7,10) → 白(0,3) → 黑(7,11)
再验三个反例:① 点棋盘外面不该落子;② 点已经有子的格子不该落子、也不该换人; ③ 获胜后再点,棋盘应该"不理你"。
学生卡住时别急着看积木,先让他做这三步:
① 打开底部变量监视,看 行、列、索引、连数 是不是预期的值;
② 看运行日志里"广播:落子(N 个接收方)"的 N 有没有异常增长;
③ 右键一块积木选禁用,逐段排除——这是最快的二分定位法。
03第三课时 · 扩展挑战
核心版本能玩了,但"能玩"离"好玩"还有距离。以下任务按难度排序,可分组选做。
3.1 悔棋:用列表存"历史"
思路:每落一子,把索引记进 历史 列表。悔棋就是取出最后一项,把那格改回 0,再删掉这颗棋子。
| 步骤 | 做法 | 新用到的积木 |
|---|---|---|
| 记录 | 落子后:将 索引 加入 历史 | 删除 列表 的第 n 项 删除此克隆体 |
| 取最后一步 | 历史 的第 (长度) 项 | |
| 还原 | 棋盘那格设为 0;删除最后画的克隆体;玩家 = 3 − 玩家 |
"删除最后画的那颗子"需要克隆体自己知道"我是第几颗"。办法:克隆体启动时,把自己的序号存进一个……(提示:这里会遇到"克隆体没有私有变量"的问题, 常见解法是用造型/大小编码,或干脆整盘重画——先让学生讨论,不急着给答案。)
3.2 电脑对手:从"瞎下"到"会堵"
按三档递进,每一档都能立刻感受到"变强了":
| 难度 | 策略 | 实现要点 |
|---|---|---|
| ★瞎下 | 随机找一个空格落子 | 随机数取索引 → 若该格 ≠ 0 就重来(重复直到) |
| ★★会堵 | 先看自己有没有四连,再堵对方四连 | 把判定逻辑写成"试落一颗,扫一遍,再撤销" |
| ★★★会算 | 对每个空位打分(活三、冲四权重不同),取最高分 | 用列表存"每个空位的分数",取最大值的位置 |
「试落 → 判定 → 撤销」是搜索的原型。学生在这里第一次体会到"程序可以假装下一步看看后果", 这是从"按步骤执行"跃迁到"会思考"的关键一步。
3.3 更多玩法
- 棋盘可调:把 15 改成 9 或 19,索引公式里的 15 也要同步改——体会"魔法数字"带来的维护成本。
- 落子提示:鼠标悬停时,在最近的格点显示一个虚线小圈(用一个"提示框"角色的克隆体跟着鼠标跑)。
- 计时与回合:每方 30 秒,超时自动换人,用计时器积木实现。
- 悔棋次数限制、禁手规则、胜负记分板(连赢 3 局显示总冠军)。
A附录
A1 积木 ↔ Python 对照表
点编辑器右上角「代码」,同一套积木会生成真实的 Python。这张表帮你对上号(注意列表编号差 1):
| 积木 | 生成的 Python | 说明 |
|---|---|---|
| 将 0 加入 棋盘 | list_add(棋盘, 0) | 等价 board.append(0) |
| 棋盘 的第 n 项 | list_item(棋盘, n) | 等价 board[n-1] |
| 将 棋盘 的第 n 项替换为 v | list_replace(棋盘, n, v) | 等价 board[n-1] = v |
| 棋盘 的长度 | list_length(棋盘) | 等价 len(board) |
| 四舍五入 | round(x) | 就近取整 |
| 重复 n 次 | for _ in range(n): | 循环 |
| 重复直到 条件 | while not (条件): | 先做后判 |
| 广播 "落子" 并等待 | broadcast_and_wait("落子") | 跨角色协同 |
| 当收到 "落子" | def on_receive_落子(): | 消息处理函数 |
| 我是克隆体? | me.is_clone | 区分本体与克隆 |
手写 Python 版的核心片段(与积木一一对应,可直接讲解):
def on_click(): if 胜者 > 0: return # 已经结束 列 = round((mouse_x() + 154) / 22) 行 = round((154 - mouse_y()) / 22) if not (0 <= 行 <= 14 and 0 <= 列 <= 14): return 索引 = 行 * 15 + 列 + 1 if list_item(棋盘, 索引) != 0: return # 这格有子了 list_replace(棋盘, 索引, 玩家) broadcast_and_wait("落子") broadcast_and_wait("检查胜负") 玩家 = 3 - 玩家
A2 常见错误 8 条
| 现象 | 原因 | 怎么修 |
|---|---|---|
| 点一下出现几十颗子 | 克隆体也执行了"落子"脚本 | 脚本开头加「如果 我是克隆体?那么 停止这个脚本」 |
| 子总是偏半格 | 用了向下取整,或者格距不是 22 | 改用四舍五入;核对 154 = 14×22÷2 |
| 点第一格没反应,点最后一格出错 | 索引少了 +1,或范围检查写成 0–13 | 索引 = 行×15+列+1;范围是 0–14 |
| 落子后不换人 | 「3 − 玩家」写成了「玩家 − 3」或忘了写 | 用变量监视看 玩家 是否翻转 |
| 明明五连却没判胜 | 反方向忘了重置 前进 / 断了吗 | 两个方向各自重置为 1 和 0 |
| 隔着空位也算连 | 缺外层「如果 断了吗 = 0」 | 补上"刹车"判断 |
| 胜利提示一闪而过 | 说了 0 秒(无限)又被下一句覆盖 | 统一用 3 秒,且判定只广播一次 |
| 改了变量初始值,重新运行还是旧值 | 运行时的值不会写回作品(这是好事) | 要改初始值请在「属性 → 变量」里改 |
A3 评价量规
| 维度 | 合格(C) | 良好(B) | 优秀(A) |
|---|---|---|---|
| 功能完整 | 能落子、能画子 | 能正确判五连、能换人 | 合法性检查齐全,结束后不再响应点击 |
| 数据设计 | 会用列表存棋盘 | 索引公式正确,读写一致 | 能说清"为什么 15、为什么 +1",并复用到别处 |
| 算法理解 | 知道要扫四个方向 | 能独立写出一个方向的扫描 | 能解释"断了吗"的作用,并迁移到新问题 |
| 工程习惯 | 会运行、会看报错 | 会用变量监视定位问题 | 会用禁用积木二分排查,代码整洁、命名清晰 |
| 表达协作 | 能演示自己的作品 | 能讲清一段积木在做什么 | 能当"小老师"帮同伴定位 bug |
A4 板书与时间轴(90 分钟)
| 时间 | 环节 | 关键动作 |
|---|---|---|
| 0–8′ | 情境导入 | 跑一遍成品,问:"电脑是怎么知道你已经赢了?" |
| 8–20′ | 需求拆解 | 填 1.1 表格,明确今天只做 ① ② |
| 20–38′ | 列表 + 初始化 | 任务 1 手算 + 任务 2 改循环 |
| 38–45′ | 坐标换算 | 板书公式,抽 2 人上台手算 |
| 45–55′ | 休息 / 快练 | 用"鼠标坐标"积木做一个小实验:屏幕左上角读数是多少 |
| 55–70′ | 落子 + 画子 | 讲广播与克隆,重点讲"克隆体重复响应"的坑 |
| 70–85′ | 判胜负 | 先画图 4、图 5,再拼积木;任务 3 验收 |
| 85–90′ | 小结 | 回看 1.1 表格第 3 列,检查自己填的能不能对上 |
必做:把棋盘改成 9×9 并跑通(提示:格距、半宽、索引里的 15 都要改)。
选做:加"悔棋"按钮,能连悔 3 步。
挑战:让电脑自动落子(随机版即可),人机对弈一局。
打开积木星球 → 首页「五子棋对弈」模板,即可看到本讲义的完整成品工程(含 13 个变量、3 个列表、4 段脚本、 带中文注释的 Python 代码)。建议教师先自己玩通一局,再带着学生拆。