AI 玩转鸿蒙(3):语法错误全自动修复,小白也能上手

AI 玩转鸿蒙（3）：语法错误全自动修复，小白也能上手 

万少：华为HDE、鸿蒙极客

个人主页：https://blog.zbztb.cn/

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 规则文件 

我的规则文件（重点） 

规则文件的作用至关重要，特别是开发约定部分。

以下是流蓝卡片项目的规则文件示例：

markdown

# 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 编辑器根据当前系统生成构建-运行程序的脚本。

演示使用 

自动构建-发现错误-自动修复 

通过项目规则管理流程 

将上述流程纳入项目规则管理：

json

{
"项目规则": {
"1": "使用之前的项目规则文件",
"2": "每一次生成代码完毕后，都要主动调用构建脚本 install.ps1 来构建和修复程序",
"3": "当构建脚本 install.ps1 检查没有错误了，就自动提交到 git"
  }
}

六、下期预告 

如何极速接入云端能力

华为鸿蒙 - 端云一体能力 

腾讯 CodeBuddy 内置 CloudBase 

• 操作云端数据库
• 后端接口对接

让应用从单机升级为联网应用！

关注我，持续分享鸿蒙开发 + AI 提效的实战技巧。