鸿蒙 ArkTS 实战:2048 小游戏的网格状态管理与滑动合并算法

举报
yd_262326817 发表于 2026/11/11 02:16:46 2026/11/11
【摘要】 以鸿蒙开发实践中心的 2048 案例为蓝本,拆解如何用 @State 二维数组描述棋盘、把「移动—合并—补位」拆成纯函数,并用矩阵转置把四个方向统一成一套逻辑。

一、2048 看起来简单,坑却都在状态模型里

鸿蒙开发实践中心里有不少适合练手的小案例,2048 是其中最容易被低估的一个。界面只有一个 4×4 棋盘和四个方向的手势,但真正动手时会发现:如果把「移动、合并、补位、判定结束」全塞进手势回调里,代码很快会变成四套几乎一样又各自带 bug 的分支。

我的做法是把规则层抽成一组不依赖 UI 的纯函数,ArkUI 只负责把二维数组画出来。这样规则可以单独写单元测试,改动画或换容器也不影响逻辑。

二、用二维数组描述棋盘

棋盘状态用一个 4×4 的二维数组即可,0 表示空格。在 ArkTS 里用 @State 装饰,数组整体替换后框架会触发重新渲染:

@State grid: number[][] = Array.from({ length: 4 }, () => Array(4).fill(0));
private size = 4;

这里有个细节:不要直接修改 grid[i][j] 后指望刷新。ArkTS 的状态观测对嵌套数组的原地写入并不总是可靠,稳妥方式是让规则函数返回一个新数组,再整体赋值 this.grid = next。这也顺带让「撤销一步」变得很容易实现——保存上一份数组即可。

三、一次滑动拆成三步纯函数

以「向左」为例,一行 [2, 0, 2, 4] 的处理可以拆成:

  1. compact:去掉中间的 0,得到 [2, 2, 4];
  2. merge:从左往右扫描,相邻且相等则合并为两倍并跳过下一个,得到 [4, 4],同时累加得分;
  3. pad:末尾补 0 回到固定长度,得到 [4, 4, 0, 0]。
function compact(row: number[]): number[] {
  return row.filter(v => v !== 0);
}

function merge(row: number[]): { row: number[]; score: number } {
  const out: number[] = [];
  let score = 0;
  for (let i = 0; i < row.length; i++) {
    if (i + 1 < row.length && row[i] === row[i + 1]) {
      const v = row[i] * 2;
      out.push(v);
      score += v;
      i++; // 合并后的格子本回合不再参与合并
    } else {
      out.push(row[i]);
    }
  }
  return { row: out, score };
}

「合并后的格子本回合不再参与合并」是 2048 最常写错的一条规则。[2, 2, 2, 2] 向左应该是 [4, 4, 0, 0] 而不是 [8, 0, 0, 0],那个 i++ 就是关键。

四、四个方向只写一套逻辑

与其为上下左右各写一遍,不如先用矩阵变换把棋盘「转」到目标都等价于向左,处理完再转回去:

  • 向右:每行先反转,向左处理后再反转回来;
  • 向上:先转置,向左处理后再转置回来;
  • 向下:转置 + 每行反转,处理完逆序还原。
function transpose(m: number[][]): number[][] {
  return m[0].map((_, c) => m.map(r => r[c]));
}
function reverseRows(m: number[][]): number[][] {
  return m.map(r => [...r].reverse());
}

这样一来,手势回调只需要根据 SwipeGesture 的方向选择一组变换组合,核心规则始终只有「逐行向左」一份代码,测试覆盖也从四份缩到一份。

五、补位、得分与结束判定

只有在棋盘确实发生变化时才补一个新块,否则用户滑到边界会白白多出格子。补位从所有空格里等概率取一个,按 90% 生成 2、10% 生成 4:

const empties: number[][] = [];
this.grid.forEach((r, i) => r.forEach((v, j) => {
  if (v === 0) empties.push([i, j]);
}));
if (empties.length > 0 && changed) {
  const [i, j] = empties[Math.floor(Math.random() * empties.length)];
  next[i][j] = Math.random() < 0.9 ? 2 : 4;
}

结束判定同样是纯函数:只要还存在空格,或任一行/列存在相邻相等,就还能继续。把这个判断和「是否出现过 2048」分开,就能干净地弹出胜利与失败两种提示。

六、ArkUI 渲染与小优化

视图层用 Grid 配合 ForEach 遍历 16 个格子,数值决定背景色与字号,避免为每种数字写一套分支组件。手势用 onGesture 里的 SwipeGesture 监听,取 angle 判断主轴方向即可;同时给容器加上 .hitTestBehavior 的合理设置,防止滑动被父组件吞掉。

再往前一步,可以把 grid 和 score 用 Preferences 持久化,实现断点续玩;规则层因为已经是纯函数,加一个 undo 栈也只是多存几份数组。

小结

2048 的价值不在于棋盘本身,而在于它把一个典型的前端问题压缩得很清晰:状态该怎么建模、哪些逻辑必须脱离 UI、如何用变换消除重复分支。把这三件事想明白,再去看鸿蒙案例里那些带云端聚合、多端协同的项目,思路会顺很多。规则层独立之后,单测、撤销、存档这些能力都是顺手就能加的,而不是后期重构才能补的债。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。