用HarmonyOS数独小游戏练手：ArkUI声明式UI与端侧持久化初探

今天在鸿蒙开发实践中心学习了“数独小游戏”案例，并在 AI DevSpace 里做了体验，本文把两件事的学习笔记记下来，供同样刚入门的开发者参考。

一、案例是什么

这个案例是一款 HarmonyOS 原生数独小游戏，纯端侧运行，不需要联网。它的主要功能包括：

• 9x9 九宫格棋盘，支持点击格子填入数字；
• 内置 54 道分级题库，按难度分级；
• 实时行、列、宫冲突校验，填错的数字会马上提示；
• 通关进度本地持久化，退出后再打开可以继续玩。

案例的开发框架是 HarmonyOS NEXT，开发语言是 ArkTS，开发工具是 DevEco Studio，运行设备是真机或模拟器。代码仓地址是 https://gitcode.com/harmony-practice-center/Harmony-APP-sudoku 。

二、值得抄作业的三个设计

1. 声明式 UI：界面跟着状态走

ArkUI 的声明式写法很适合数独这种格子界面：棋盘、候选数字、难度按钮都是状态驱动的视图。状态变了，界面自动刷新，不需要手动操作单个格子。初学时，先把“格子状态”这个数据模型理清楚，再写界面会顺很多。

2. 冲突校验：落子时只算相关的一行、一列、一宫

数独的规则很简单，每一行、每一列、每一个 3x3 宫内，数字 1 到 9 不能重复。校验时不需要全盘扫描，只检查落子位置所在的行、列、宫即可。这样既直观，性能也够用。把校验写成一个纯函数，输入棋盘和坐标，输出是否冲突，测试起来很方便。

3. 端侧持久化：进度存在本地文件

通关进度和当前棋盘状态保存在本地文件中，下次打开应用时再读出来。做持久化时要注意两点：一是写入最好是原子性的，避免写到一半被打断导致文件损坏；二是读取时要做容错，读不到或格式不对时，用默认状态兜底，而不是闪退。

三、怎么跑起来

1. 从 GitCode 克隆代码仓；
2. 用 DevEco Studio 打开其中的 harmony_app 工程；
3. 按官方文档的运行说明，把应用安装到真机或模拟器上运行。

按案例说明，支持 HarmonyOS NEXT 系统，开发前建议先确认 DevEco Studio 的版本与案例要求一致。

四、AI DevSpace 体验

同一个上午，我还体验了 AI DevSpace 的体验版：进入后环境自动准备就绪，左侧是 AI Shell 对话面板。我在 AI Shell 里问了一句“请用一句话介绍 AI DevSpace”，它回答说 AI DevSpace 是华为云面向开发者的一站式 AI 开发平台，提供预置作业环境、工具集成与可分享的深链能力，让开发者无需繁琐配置即可快速搭建、运行和分享 AI 开发工作流。整个过程不需要自己装环境，对想快速验证想法的新手比较友好。体验版容器会在 3 小时后释放，再次启动会创建全新容器，重要文档要及时保存。

五、小结

数独这个案例不大，但把“状态驱动界面、纯函数校验、本地持久化”这条主线讲得很清楚。下一步我打算在它的基础上做两件事：一是给棋盘加上候选数字的自动提示，二是把通关时间也记录下来，做一个简单的本地排行榜。