AI 玩转鸿蒙（3）：语法错误全自动修复，小白也能上手
万少：华为HDE、鸿蒙极客
2025年参与孵化了20+鸿蒙应用、技术文章300+、鸿蒙知识库用户500+、鸿蒙免费课程2套。
如果你也喜欢交流AI和鸿蒙技术，欢迎扣我。
最近我在B站上进行不定期的免费鸿蒙技术直播，欢迎关注：https://space.bilibili.com/414874315?spm_id_from=333.33.0.0
配套视频：https://www.bilibili.com/video/BV1qer6B2EbZ/#reply115885784239939
前言：AI 提效，让开发更轻松
去年在参加激励赛期间，我所有的应用都是用 AI 完成的。在企业上班的同时，我采用"AI 编程 + 自己忙一些事"的并行方式，真正体验到了技术带来的便利和收益！
一、痛点：AI 编辑器开发鸿蒙代码，经常有语法错误
使用 AI 编辑器开发鸿蒙应用时，经常会遇到各种语法错误：
使用 TypeScript 语法导致错误、函数签名用错
手动复制错误信息给 AI 工具，整个过程体验很差，效率低下。
通过配置，在 AI 编辑器中实现：一次对话，做到语法不出错（即使出错了，也能自动修复）
二、选择合适的 AI 编辑器工具
Claude + Code：Token 费用高 + 中转问题、海外版 Trae + Gemini-3-Pro
三、项目规则：让 AI 更懂你的项目
不同的 AI 编辑器都有自己生成项目规则的做法，一般都是在工程内新建 MD 规则文件。
Trae 规则文件
Qoder 规则文件
我的规则文件（重点）
规则文件的作用至关重要，特别是开发约定部分。
以下是流蓝卡片项目的规则文件示例：
# FlowCard - HarmonyOS 应用项目
## 项目概述
这是一个基于 **HarmonyOS NEXT (API 21)** 开发的手机应用项目，使用 **ArkTS** 语言和 **ArkUI** 声明式框架构建。项目采用 Stage 模型，是 HarmonyOS 新一代应用开发架构。
### 技术栈
- **开发语言**: ArkTS (TypeScript 的超集)
- **UI 框架**: ArkUI (声明式 UI)
- **构建工具**: Hvigor
- **目标平台**: HarmonyOS 6.0.1 (API 21)
- **设备类型**: 手机 (phone)
- **应用类型**: Stage 模型应用
### 项目信息
- **Bundle Name**: `liulankapian.qinglanzhuma.huawei`
- **版本**: 1.0.0 (versionCode: 1000000)
- **主入口**: EntryAbility
- **主页面**: Index.ets
## 项目结构flowCard/
├── AppScope/ # 应用全局配置
│ ├── app.json5 # 应用配置文件
│ └── resources/ # 应用级资源
├── entry/ # 主模块
│ ├── src/main/
│ │ ├── ets/
│ │ │ ├── entryability/ # 应用入口能力
│ │ │ │ └── EntryAbility.ets
│ │ │ ├── entrybackupability/ # 备份恢复能力
│ │ │ │ └── EntryBackupAbility.ets
│ │ │ └── pages/ # 页面文件
│ │ │ └── Index.ets # 首页
│ │ ├── resources/ # 模块资源文件
│ │ └── module.json5 # 模块配置
│ ├── src/ohosTest/ # 自动化测试
│ └── src/test/ # 单元测试
├── hvigor/ # 构建配置
├── build-profile.json5 # 构建配置文件
├── hvigorfile.ts # Hvigor 构建脚本
└── oh-package.json5 # 依赖管理文件
## 构建和运行
### 前置要求
- 安装 DevEco Studio (推荐最新版本)
- 配置 HarmonyOS SDK 6.0.1 或更高版本
- 配置签名证书 (真机运行需要)
## 开发约定
### 代码风格
- 使用 **ArkTS** 语言规范
- 采用声明式 UI 编程范式
- 组件使用 `@ComponentV2` 装饰器
### 状态管理（重要！）
⚠️ **重要约束**: 本项目只能使用 **V2 状态管理技术**，禁止使用 V1 状态管理
**使用 V2 装饰器:**
- `@ObservedV2`
- `@Trace`
- `@ComponentV2`
- `@Local`
- `@Param`
**禁止使用 V1 装饰器:**
- `@State`
- `@Prop`
- `@Link`
- `@Provide`
- `@Consume`
四、必备工具介绍
hdc 工具
hdc（HarmonyOS Device Connector）是提供给开发人员的命令行调试工具，用于与设备进行交互调试、数据传输、日志查看以及应用安装等操作。该工具支持在 Windows/Linux/MacOS 系统上运行，为开发者提供高效、便捷的设备调试能力。
hvigorw
hvigorw 作为 Hvigor 的 wrapper 包装工具，支持自动安装 Hvigor 构建工具和相关插件依赖，以及执行 Hvigor 构建命令。
五、实战演示：自动识别并修复语法错误
配置好证书（手动签名/自动签名），可以让程序运行在模拟器或者真机上。
让 AI 编辑器根据当前系统生成构建-运行程序的脚本。
演示使用
自动构建-发现错误-自动修复
通过项目规则管理流程
将上述流程纳入项目规则管理：
{
"项目规则": {
"1": "使用之前的项目规则文件",
"2": "每一次生成代码完毕后，都要主动调用构建脚本 install.ps1 来构建和修复程序",
"3": "当构建脚本 install.ps1 检查没有错误了，就自动提交到 git"
}
}六、下期预告
如何极速接入云端能力
华为鸿蒙 - 端云一体能力
腾讯 CodeBuddy 内置 CloudBase
- 操作云端数据库
- 后端接口对接
让应用从单机升级为联网应用！
关注我，持续分享鸿蒙开发 + AI 提效的实战技巧。
