鸿蒙数独小游戏：ArkUI 纯端侧开发的五个实战要点

数独看起来只是一张9×9的格子，但把它做成一款真正可玩的鸿蒙应用，规则、界面、状态和持久化缺一不可。本文以一款内置54道分级题库的数独小游戏为例，总结ArkUI纯端侧开发中最值得注意的五个实战要点。

一、先定规则，再写界面

很多数独应用的返工都源于顺序颠倒：先画好了棋盘，才发现规则没想清楚。正确的做法是先把规则写成清单：9×9棋盘由3×3的宫组成，每行、每列、每宫的数字1到9都只能出现一次；题目由完整终盘挖去若干空格生成；难度由挖空数量和解题步数共同决定。规则定下来之后，界面只是规则的可视化。

二、棋盘渲染：组件要扁，不要深

9×9共81个格子，如果每个格子都套三四层容器，渲染和刷新都会变慢。实战中的做法是让组件尽量扁平：外层按行组织，单个格子只做一件事，显示数字、候选数和状态色；行列宫的粗线用边框区分，而不是再加一层容器。选中格用浅色高亮，同时高亮同行、同列、同宫的格子。格子的状态变化只刷新受影响的格子，而不是整盘重绘。

三、冲突校验：写在状态变更处，而不是提交时

数独最容易做错的地方是校验时机。如果等玩家填满一整盘再统一检查，错误早已埋下，定位也很困难。正确的做法是把校验写在每一次数字填入的瞬间：填入后立即检查同一行、同一列和同一宫是否出现重复数字，有冲突的格子马上标红，玩家当场就能发现并改正。校验函数本身要保持纯粹，只接收棋盘和坐标，返回冲突的格子集合，不直接改界面；界面层只负责把结果渲染出来。

function hasConflict(b:number[][],r:number,c:number){
  const v=b[r][c];
  for(let i=0;i<9;i++) if((i!==c&&b[r][i]===v)||(i!==r&&b[i][c]===v)) return true;
  return false;
}

四、题库分级：难度来自挖空，而不只是题量

54道题听起来不少，但如果难度拉不开，玩家玩两局就会腻。分级的关键是把难度做进生成过程：先生成完整终盘，再按难度挖去不同数量的空格，简单题挖空少、线索多，进阶题挖空多、需要借助候选数推理；生成后还要用求解器验证每道题有唯一解，否则同一道题可能出现多个答案，玩家会误以为自己填错了。题库按难度分档存放，选关界面直接按档展示。

五、进度本地持久化：只存必要的状态

纯端侧应用没有服务端，通关进度和当前棋盘只能存在本地。持久化的原则是只存恢复现场必需的状态：当前棋盘、已用时间、当前难度和已通关的关卡编号；界面上的临时高亮、选中格这类状态不需要存，下次打开重新计算即可。保存时机选在每次填数和通关之后，用轻量键值存储写入；恢复时先校验数据的完整性，损坏的数据直接丢弃并回到选关页，而不是让玩家卡在一个坏掉的棋盘上。这正是纯端侧体验的底线。

收尾：把“能玩”做成“好玩”的检查清单

做完上面五点，一款数独应用已经“能玩”，但要做到“好玩”，上线前再对照三件事检查一遍：第一，填错数字是否立刻有反馈，而不是等到最后才报错；第二，每个难度是否真的有唯一解，随机抽几道题用求解器跑一遍；第三，中途退出再进来，棋盘和计时是否原样恢复。把这五点逐一做扎实，纯端侧开发也能做出体验完整的小游戏。