鸿蒙数独小游戏案例拆解：9×9棋盘的声明式渲染与离线持久化

一、为什么数独是声明式UI的绝佳练手场

鸿蒙实践中心的数独案例全程离线运行，用 ArkTS 声明式 UI 渲染 9×9 棋盘。声明式渲染的关键在于棋盘状态即界面：81 个格子由一个二维数组驱动，@State 数组一变，界面自动重绘。命令式写法需要手动管理 81 个组件的刷新，声明式一行 forEach 搞定。

二、确定性题库生成

案例的题库是确定性生成而非随机：以种子数控制挖洞位置与数量，保证同一难度每次生成的盘面一致。这样做有两个工程好处——难度可标定可回归测试，以及玩家复盘时题面可复现。随机方案若要达到同样效果，就得把整盘题面落盘。

三、本地文件持久化

进度保存用本地文件而非数据库：数独状态就是 81 个格子的数字加笔记标记，序列化成一个 JSON 足够。离线游戏的持久化原则是"状态小、写频繁、可容忍丢失"——文件方案最简单也最稳，启动时读一次、落子时写一次即可。

四、可借鉴的三点

一是状态驱动的格子高亮逻辑（选行列宫联动）完全由派生计算得出，没有冗余状态；二是笔记模式与填数模式用同一个数据结构的两个维度表达；三是错误校验放在输入入口而非渲染层，避免界面层承担业务规则。

五、小结

这个案例体量小但结构完整，适合作为 ArkUI 声明式思维的第一课：把界面理解为状态的函数，把持久化理解为状态的序列化。想入门鸿蒙游戏开发的开发者可以从它开始。