数独小游戏案例阅读笔记：ArkUI 纯端侧实现与行列宫冲突校验思路

今天在鸿蒙开发实践中心读了数独小游戏案例：HarmonyOS + ArkUI 纯端侧开发。与昨天读的 OBS 云相册案例不同，这个案例不依赖云端服务，棋盘、规则校验和计时都在端侧完成，适合作为入门 ArkUI 状态管理的练手项目。

一、案例的核心结构

案例把 9×9 棋盘按 3×3 宫格划分，功能包括难度选择、计时、错误提示和提示功能。阅读时可以先抓三条线：棋盘数据如何表示、格子状态如何区分（题目给定的固定格与用户填写格）、用户每次填数之后界面如何刷新。抓住这三条线，再看界面代码就不会迷路。

二、冲突校验的思路

数独的规则只有一句话：同一行、同一列、同一个 3×3 宫内，数字 1 到 9 不能重复。校验时分三步走：1）行校验：检查目标格所在行是否已存在这个数字；2）列校验：检查目标格所在列是否已存在这个数字；3）宫校验：用行号除以 3、列号除以 3 定位宫的左上角，再检查宫内 9 个格子。三个检查都通过，这个数字才能填入。实现时要注意把空格（空值）排除在重复判断之外，否则空位会被误判为冲突。

校验时机有两种做法：填入时立即校验，填错马上提示；或者整盘填完后统一校验。前者反馈快、适合做游戏，后者逻辑简单、适合做解题器。给新手的建议是先写一个纯函数，例如判断在指定行列填入某个数字是否合法，再把这个函数接到界面事件上，这样函数可以单独测试。

三、一个可直接验证的小思路

用 Python 先在本地验证校验逻辑，再搬到 ArkUI 里，思路完全一样：9×9 棋盘用二维列表表示，空格用 0 表示，写一个 is_valid 函数，分别扫描行、列和宫。今天我在 AI 开发者空间里请 AI 写这个逻辑时，第一次让它直接生成代码文件，工具日志显示已完成但工作区里一时找不到文件；改成先请它用文字讲清校验思路，反而一次就拿到了完整说明。给同样用 AI 辅助学习的读者一个提醒：把“生成代码”和“讲解思路”分两步提，出现异常时更容易定位问题。

四、阅读建议

读这类案例不用逐行背代码。先弄清棋盘数据的结构，再把冲突校验函数单独抠出来跑通，最后对照难度、计时这些外围功能看状态如何流转。能把校验函数讲清楚、自己改一个难度或加一个错误计数，就算读透了。注：本文基于 2026-11-08 当日在鸿蒙开发实践中心的阅读与在 AI 开发者空间的实测记录。