企业官网建设流程全解析

适用AI工具：Cursor
前置博客：第01篇
预计阅读时间：20分钟

一、为什么 Cursor 值得鸿蒙开发者认真配置？

Cursor 的底座是 VS Code，配合 Composer 2.5 模型在 SWE-Bench Multilingual 上拿下 79.8% 的成绩，多文件编辑体验是当前 IDE 赛道的天花板。但它的默认训练语料里，ArkTS 与 HarmonyOS 的占比远低于 TypeScript 与 Android——开箱即用状态下，它生成的"ArkTS"常常带着浓浓的 TS/React 味：随手用any、对象字面量不带类型、组件写法脱离 ArkUI 约束。

解法有两个，正好对应本文两个主题：

1. Rules：把鸿蒙工程规范写进规则文件，强制注入每次生成的上下文；
2. MCP：把鸿蒙工具链（编译、包管理、模拟器控制）封装成 MCP 服务器，让 AI 从"猜代码"升级为"跑代码、看结果、自己改"。

配置完成后，Cursor 会从"通用 AI 编辑器"变成"半个鸿蒙 IDE"。

二、Rules：把 ArkTS 规范注入 AI 上下文

2.1 Rules 的组织方式

Cursor 支持.cursor/rules/*.mdc规则文件，每条规则可指定触发范围（globs）。针对鸿蒙工程，建议按职责拆成三到四条规则，而不是塞成一个大文件：

.cursor/rules/ ├── arkts-core.mdc # ArkTS 语言约束（全工程生效） ├── arkui-ui.mdc # ArkUI 组件与状态管理（*.ets 生效） └── harmony-project.mdc # 工程结构与配置文件（*.json5 生效）

2.2 arkts-core.mdc：语言层约束

--- name: arkts-core globs: **/*.ets --- # ArkTS 强约束（HarmonyOS NEXT） - 禁用 any/unknown：所有变量、参数、返回值必须显式类型 - 对象字面量必须对应显式 interface/class，禁止匿名结构 - ForEach 循环必须添加类型标注，禁止隐式推断 - 禁止使用元组、解构赋值、展开运算符于对象 - 类成员必须显式初始化或声明为可选 - 只允许 import 显式导出的符号，禁止动态 import 字符串拼接

这些规则直接对应 ArkTS 的编译期检查。写进 Rules 后，AI 生成代码的首次编译通过率显著提升——对 AI 而言，约束越显式，输出越稳定。

2.3 arkui-ui.mdc：UI 层约束

--- name: arkui-ui globs: **/*.ets --- # ArkUI 声明式规范 - 状态装饰器选型：组件内用 @State，父子传递 @Prop/@Link， 跨层传递 @Provide/@Consume，对象数组更新用 @Observed+@ObjectLink - 列表渲染：长列表一律 LazyForEach + IDataSource，禁止裸 ForEach - 组件复用：@Builder 抽取重复 UI，@Styles 抽取通用样式 - 布局优先级：Flex > Grid > 手动百分比；禁止绝对布局堆叠业务 UI - 资源引用：字符串/颜色/尺寸一律 $r('app.xxx')，禁止硬编码

2.4 harmony-project.mdc：工程层约束

--- name: harmony-project globs: **/*.json5 --- # 工程配置规范 - module.json5 新增 Ability 必须同时声明 abilities 与对应 type - 权限申请必须写入 requestPermissions 并说明用途 - 依赖只加到 oh-package.json5，禁止手动改 lock 文件

三、MCP：让 AI 能操作鸿蒙工程

Rules 解决"写得对"，MCP 解决"跑得动"。通过 MCP 服务器，Cursor 里的 AI 可以执行hvigorw构建、hdc设备命令、查模拟器日志——形成"生成 → 构建 → 看报错 → 修复"的自动闭环。

3.1 配置 MCP 服务器

在工程.cursor/mcp.json中声明：

{"mcpServers":{"harmony-build":{"command":"node","args":["./mcp-tools/hvigor-server.js"],"env":{"HOS_SDK_HOME":"C:/Huawei/Sdk"}},"harmony-device":{"command":"node","args":["./mcp-tools/hdc-server.js"]}}}

两个服务的核心逻辑都很薄：harmony-build封装hvigorw assembleHap --mode module -p product=default并回传编译输出；harmony-device封装hdc install、hdc shell aa start、hdc shell hilog三条高频命令。社区已有现成实现，也可以用 DevEco CLI 提供的开放能力直接对接。

3.2 闭环实战：让 AI 自己修编译错

配置完成后，对话可以这么写：

构建 HAP，如果失败请根据报错自行修复后重试，直到构建通过。

Cursor 的 Agent 模式会依次：调用harmony-build→ 收到报错"Property ‘push’ does not exist on type ‘readonly …’" → 定位到 AI 自己刚生成的代码把数组声明成了只读 → 改为Array<T>→ 重新构建 → 通过。整个循环无需人工介入，这正是 MCP 的价值：AI 的错误能被 AI 自己看见。

四、Composer 2.5 多文件编辑实战

Composer 是 Cursor 的多文件协同编辑入口（Ctrl+I）。它的杀手锏是跨文件一致性：一次指令，同时改模型、页面、路由三个文件并保持引用正确。

实测指令示例：

新增收藏功能：model 层加 FavoriteModel（preferences 持久化）；
列表页每项加收藏按钮（心跳动画）；详情页读取收藏状态；
更新路由参数定义。

Composer 会给出涉及 4 个文件的完整 Diff：新增文件以绿色呈现，修改文件以逐行 Diff 呈现。逐文件 Review 后统一 Accept。配合第二节的 Rules，生成代码可直接通过 ArkTS 编译的情况是常态。

五、踩坑记录

• 规则不生效：.mdc文件格式错误或globs写错。用 Cursor 状态栏的 Rules 面板确认规则是否被当前文件命中。
• MCP 连不上：env里的 SDK 路径写成了正斜杠开头；Windows 下用C:/Huawei/Sdk而非C:\Huawei\Sdk。
• 上下文膨胀：规则文件宜精不宜多，三条规则总行数控制在 200 行内，超出部分 AI 反而会忽略。
• 旧工程索引慢：把oh_modules、build加入.cursorignore，索引速度提升数倍。

六、下一步

至此工具层准备完毕。下一篇进入核心能力篇：用 AI 辅助做 ArkTS 性能优化——从冷启动瀑布图到 120Hz 满帧。