积木星球 · 项目式课程

用积木做一个
能对弈的五子棋

学生第一次遇到"游戏需要记住状态"的问题:棋盘上的每一颗子,都得被程序记住。 这份讲义用五子棋把列表、双重循环、坐标换算、方向扫描串成一条完整的工程链—— 从点一下鼠标,到屏幕上多出一颗子,再到程序喊出"黑棋获胜"。

适用学段小学高年级 – 初中
建议课时2 课时 + 1 扩展
前置知识变量 · 循环 · 条件
工具积木星球 BlockPlanet

00课程总览

先说清楚"学完能做什么",再拆成可验收的小目标——这是所有工程项目的第一课。

学完这节课,学生能做到

维度具体表现(可观察、可验收)
知识解释"列表 = 带编号的储物柜";说出 索引 = 行 × 15 + 列 + 1 里每个数字的含义;说明为什么判定要从落点向四个方向扫。
技能独立用鼠标坐标换算出格点坐标并落子;用"列表第几项"读取/替换棋盘;用双重循环 + 标志变量实现"最多数 4 格,遇到空就停"。
素养能把一个大问题("做个五子棋")拆成 5 个子问题;能用"打印/监视变量"定位 bug,而不是盲目改积木。
本课核心价值链

点一下鼠标 → 坐标换算成 (行, 列) → 换算成列表索引 → 写入列表(程序记住了)→ 广播让"棋子"角色画出这颗子 → 以落点为中心四方向扫描 → 数到 5 个同色就宣告胜利。

为什么用五子棋做项目

它逼你面对"状态"

打地鼠不需要记忆,五子棋必须记住 225 个格子的历史。这是从"动画"跨到"程序"的分水岭。

它有天然的二维数据

15×15 的棋盘正好讲"二维压成一维"——同一套索引公式,未来做扫雷、俄罗斯方块、地图都能用。

它的算法短而完整

判定逻辑只有 4 个方向 × 2 个方向 = 8 次扫描,却是真实的"游戏 AI 判定"雏形。

它有胜负,学生上瘾

做完就能和同桌对弈,"能玩"是最好的验收标准,也是最好的学习动机。

教师提示 · 课前 5 分钟

打开模板「五子棋对弈」直接跑给学生看:点几下,黑棋连成五子,程序弹出"⚫ 黑棋连成五子,获胜!"。 然后关掉运行,点开"代码"面板——一句句 Python 就是刚跑的积木。先给震撼,再拆零件。

01第一课时 · 让棋盘"记住"棋子

本课时只解决一件事:把屏幕上看得见的棋盘,变成程序里存得住的数据。

1.1 先拆需求,再动手

直接说"做个五子棋"学生会懵。把它写成 5 行需求,每行对应一个技术手段——这张表就是整个项目的施工图:

#要做的事技术手段用到的积木
1记住每个格子是空 / 黑 / 白一个 225 项的列表列表 替换列表项
2知道玩家点了哪一格鼠标坐标 → 四舍五入 → 行列鼠标 x 坐标 四舍五入
3屏幕上多出一颗子广播 → 设造型 → 移到 → 克隆广播并等待 克隆自己
4判断是否五连以落点为中心,四方向扫描重复 4 次 列表第几项
5宣布胜负、切换下一方广播 + 变量 3 − 玩家说 播放声音
教学动作 · 让学生自己填第 3 列

只给第 1、2 列,让学生讨论"这件事程序要怎么做"。写不出来没关系,留空——等做完 2.2 再回头补,前后呼应。

1.2 棋盘 = 一个 225 项的列表

把棋盘想成一个 15 行 × 15 列 的储物柜,每个格子里放一个数字:

值含义屏幕上
0这格是空的什么都没有
1黑子,或者"轮到黑棋"一颗黑子
2白子,或者"轮到白棋"一颗白子

程序只需要一个列表就能装下整盘棋:棋盘 = [0, 0, 0, … 共 225 个]。 变量只能存一个值,列表能存一整张表——这就是列表存在的理由。

易错点 · 编号从 1 开始

积木星球的列表和 Python 的列表不一样:积木里「第 1 项」是第一项(跟我们数数一致), Python 里 board[0] 才是第一项。讲义里所有公式都按积木的从 1 开始写; 看代码面板时记住"差 1",附录 A 有一张对照表专门讲这个坑。

1.3 坐标换算:鼠标点在哪一格

舞台中心是 (0, 0),x 向右为正、y 向上为正。我们的棋盘格距 22,从 −154 到 +154 正好 15 个格点:

+x +y (0, 0) x = 9×22 − 154 = 44 y = 154 − 7×22 = 0 列 col → 行 row ↓ 0 14 0 14 反解公式 列 = 四舍五入( (鼠标x + 154) ÷ 22 ) 行 = 四舍五入( (154 − 鼠标y) ÷ 22 ) 黑子那一格 鼠标 (44, 0) → 列 = (44+154)/22 = 9 → 行 = (154−0)/22 = 7 为什么是 +154 / 22 棋盘最左边 = −154 每格 22 像素
图 1 舞台坐标(x 右为正、y 上为正)与棋盘格点的换算关系

把公式写进积木,就四块:

将 列 设为 四舍五入( ( 鼠标 x 坐标 + 154 ) ÷ 22 )
将 行 设为 四舍五入( ( 154 − 鼠标 y 坐标 ) ÷ 22 )
为什么用"四舍五入"而不是"向下取整"

格点是离散的 15 个点,鼠标落在格点之间(比如两线中间)时,四舍五入会自动吸附到最近的那个交叉点—— 手感最像真实棋盘。取整会产生"偏左半格永远点不上"的问题。

课堂任务 1 · 手算 4 格(5 分钟)

不碰电脑,用公式算出下列鼠标坐标对应哪一格,填表后交换检查:

鼠标坐标列行鼠标坐标列行
(0, 0)??(−154, 154)??
(88, 0)??(154, −154)??

答案:列 7/行 7 | 列 11/行 7 | 列 0/行 0 | 列 14/行 14

1.4 索引公式:二维压成一维

列表只有一根"长抽屉",而棋盘是二维的。所以要把 (行, 列) 压成一个编号:

第 0 行(索引 1 – 15) 1 2 … 15 ← 行 0 的 15 项 第 7 行(索引 106 – 120) 106 107 … 115 116 … 120 ← 第 9 列在这里:115 索引 = 行 × 15 + 列 + 1 行 7、列 9 → 7×15 + 9 + 1 = 115 为什么要 +1 积木列表从 1 开始数
图 2 行 × 15(每行 15 格)+ 列(行内偏移)+ 1(编号起点)

记住这句口诀就更不会错:「先跳过前面 7 整行,再走 9 格,最后加 1 开始数」。

1.5 动手:把 225 个 0 装进列表

点右上角「属性 → 列表 → 新建列表」,建一个叫 棋盘 的空列表。然后用循环填满它:

当 🏁 被点击
删除 棋盘 的全部项目          # 开局先清空
重复 225 次                   # 15 × 15 = 225 个格子
    将 0 加入 棋盘          # 每一格先都是"空"
将 玩家 设为 1                # 1 = 黑棋先行
将 胜者 设为 0
验证方法(一定要做)

点运行 → 打开底部「变量监视」→ 应该看到 棋盘(列表 · 225 项) 后面一串 0 0 0 0 …。 数字不对就是循环次数写错了;一项都没有就是「删除/加入」的列表选错了。

课堂任务 2 · 改一改看看(8 分钟)
  1. 把 重复 225 次 改成 重复 15 次,运行后列表几项?为什么?
  2. 改成 重复 15 次 里再套一个 重复 15 次,结果一样吗?哪个写法更能说明"15 行 × 15 列"?
  3. 把「加入 0」改成「加入 行」,观察列表内容——你发现了什么?(提示:循环没有"当前第几次"的概念,得自己加计数器变量)
教师提示 · 第 3 问是伏笔

学生很快会发现"循环不知道自己是第几圈"。这个痛点正是第二课时「前进」变量存在的原因—— 先让他们撞墙,再给工具,接受度完全不同。

02第二课时 · 落子、画子、判胜负

这一课时把"点击"变成"一颗子 + 一次判定"。算法不难,难在顺序——顺序错了,判定就会用旧数据。

2.1 落子要过四道关

玩家的每一次点击,程序都要先审一遍再执行。这叫合法性检查,是所有游戏的基本功:

关检查什么条件(积木)不通过怎么办
1游戏是不是已经结束胜者 > 0直接 停止这个脚本,什么都不做
2棋盘是否已初始化棋盘 的长度 < 225
3点的是不是棋盘范围内不成立( 行、列 都在 0–14 之间 )同上(点了棋盘外面)
4这一格是不是空的棋盘 的第 索引 项 = 0不落子,就是"这里已经有子了"
第 3 关为什么要用"不成立"包起来

积木没有「并且」加「或者」连成一长串的简洁写法,四条件与起来会拼出很大的积木块。 换个思路:先算"在范围内"这个条件,再取反——不成立( 行>−1 与 行<15 与 列>−1 与 列<15 ), 一个"不成立"就同时管住了越界的所有情况。

四道关都过了,才真正落子。注意这 4 行的顺序不能颠倒:

# ① 写入棋盘(程序"记住"了)
将 棋盘 的第 索引 项替换为 玩家
# ② 让棋子角色把这颗子画出来(等人画完再往下)
广播 "落子" 并等待
# ③ 判定胜负(用刚写入的新棋盘)
广播 "检查胜负" 并等待
# ④ 换人:1→2,2→1   (3 − 1 = 2)
将 玩家 设为 3 − 玩家
「3 − 玩家」是编程里的小魔法

不用写"如果 玩家=1 那么设为 2,否则设为 1"两个分支。因为只有 1 和 2 两个值,3−1=2、3−2=1。 这种"用算术代替判断"的技巧叫状态翻转,学生学会一次能记一辈子。

2.2 把子画出来:广播 + 克隆

难点来了:积木不能跨角色操作。「棋盘」角色算出了行列,却不能直接命令「棋子」角色移动。 标准解法是广播——把结果放进全局变量,喊一声,让棋子角色自己来取:

① 棋盘角色 列 = 9  行 = 7 棋盘[115] = 1 广播 "落子" 并等待 算完、写进列表,然后喊话 ② 棋子角色(收到"落子") 将造型设为 玩家 (1=黑 2=白) 移到 x: 9×22−154 y: 154−7×22 克隆自己 自己保持隐藏,只让克隆体显形 ③ 克隆体(当作为克隆体启动时) 显示 ← 继承位置和造型,显形即可 为什么用"并等待"而不是"广播" 等棋子画完再判定,屏幕上和逻辑上才同步
图 3 跨角色通信:全局变量传数据,广播传时机
必踩的坑 · 克隆体也会收到广播

棋盘上已经有 6 颗子时,再一次广播,7 个角色(1 个本体 + 6 个克隆体)都会执行落子脚本—— 克隆体再生克隆体,一秒钟就能炸出几百个。

解法是在落子脚本最前面加一句:如果「我是克隆体?」那么 停止这个脚本。 本体负责画新子,克隆体只管好好待在原地。运行日志里能看到"广播:落子(7 个接收方)"这样的记录,正好用来讲这件事。

2.3 判胜负:以落点为中心的四个方向

五连只可能经过刚下的那一颗子——所以不用扫全盘,只从落点出发看四个方向就够了:

落点 ① 横 dx=1, dy=0 ② 竖 dx=0, dy=1 ③ 正斜 dx=1, dy=1 ④ 反斜 dx=1, dy=−1 每个方向再分"正、反"两个朝向 所以一共 4 × 2 = 8 次扫描 8 次里任意一次凑够 5 颗同色 → 获胜
图 4 把 4 个方向存进两个列表,用 列表第几项 轮流取

方向不必写死 8 段积木。用两个小列表存起来,循环取值更简洁:

方向X = [ 1, 0, 1,  1 ]     # 横、竖、正斜、反斜
方向Y = [ 0, 1, 1, −1 ]

重复 4 次
    将 dx 设为 方向X 的第 方向号 项
    将 dy 设为 方向Y 的第 方向号 项
    # …… 沿 (dx,dy) 数一遍,再沿 (−dx,−dy) 数一遍
    将 方向号 增加 1
为什么反斜是 dy = −1 而不是 +1

"正斜"和"反斜"其实是一条对角线的两个朝向。取 dy=−1 就是往右上/左下走。 正反两个朝向都数,同一条对角线才会被完整数一遍,而且不重复。

2.4 单向扫描:用「断了吗」当刹车

从落点往一个方向最多只需要看 4 格(才能凑够 5)。但路上可能碰到空位、碰到对方的子、或者走出棋盘——必须停下来。 问题:积木的「重复」没有 break,怎么办?

加一个标志变量 断了吗,每次循环先问它:

往右扫(落点自己已算 1 颗,所以第一格数到就变 2):黑 黑 黑 空 黑 黑 … ● ● ● 空 ● ● 第1格第2格第3格 第4格不必看不必看 连数 2连数 3 连数 4 断了! 重复 4 次  如果 断了吗 = 0 那么   算下一格 → 是同类?连数+1 否则 断了吗=1 断了吗 = 1 之后, 后面几圈都只是"空转", 不会再多算一颗子。
图 5 用标志变量模拟"刹车",是循环里最常用的技巧之一

完整的一段(正方向)长这样,反方向把 + 换成 − 复制一份即可:

将 前进 设为 1
将 断了吗 设为 0
重复 4 次
    如果 断了吗 = 0 那么
        将 临时行 设为 行 + dy × 前进
        将 临时列 设为 列 + dx × 前进
        如果 ( 临时行 在 0–14 与 临时列 在 0–14 ) 与
           ( 棋盘 的第 (临时行×15+临时列+1) 项 = 玩家 ) 那么
            将 连数 增加 1
        否则
            将 断了吗 设为 1
    将 前进 增加 1
三个高频错法
  1. 忘了外层的「如果 断了吗 = 0」:断掉之后还在继续加 连数,会把隔着空位的子也算成连在一起。
  2. 忘了「前进 +1」:四圈都在看同一格,连数直接变 5,误判获胜。
  3. 反方向忘了重置 前进 和 断了吗:反方向只数一格就停,漏判。

2.5 宣布胜负,并把子交出去

八个方向扫完,只要 连数 > 4(也就是 ≥ 5),记下胜者并广播:

如果 连数 > 4 那么
    将 胜者 设为 玩家

# 四个方向都扫完以后
如果 胜者 > 0 那么
    广播 "游戏结束" 并等待
当收到 "游戏结束"
播放声音 "胜利"
如果 胜者 = 1 那么
    说 "⚫ 黑棋连成五子,获胜!" 3 秒
否则
    说 "⚪ 白棋连成五子,获胜!" 3 秒
课堂任务 3 · 通盘验收(15 分钟)

两人一组,用下面的顺序落子,必须在第 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 项替换为 vlist_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 代码)。建议教师先自己玩通一局,再带着学生拆。