序观
2026-11-10 17:51:06 发布在 HarmonyOS 应用开发中,页面数量增加后,重复的 UI 代码几乎不可避免。比如,多个页面都需要显示顶部导航栏、统一风格的按钮、商品卡片、列表空状态和加载提示。如果每个页面都单独实现一遍,不仅开发效率低,还容易出现样式不一致、交互行为不同和修改成本过高等问题。
AI Coding 能够快速生成 ArkUI 页面和组件,但它生成的代码并不一定天然具备复用性。很多时候,开发者让 AI 完成一个页面,它会把页面中的所有内容都写在一个较大的组件里;当另一个页面需要类似功能时,AI 又重新生成一套相似代码。结果是页面开发速度提高了,项目中的重复代码却越来越多。
要解决这个问题,可以让 AI 参与组件库建设。不过,组件库并不是把页面中的每一段代码都拆成独立组件。真正有复用价值的组件,应该具有明确的职责、稳定的输入输出和合理的配置能力。
以一个电商应用为例,首页、搜索页、分类页和收藏页都需要展示商品卡片。卡片中包含商品图片、名称、价格和促销信息,用户点击卡片后进入商品详情页。不同页面的数据来源可能不同,但卡片的基本展示结构和点击行为具有较高的相似性。
此时可以先让 AI 分析项目中重复出现的 UI:
请分析当前 HarmonyOS 工程中的页面代码。
重点寻找:
1. 多个页面重复出现的 UI 结构;
2. 样式基本一致、仅数据不同的组件;
3. 可以独立维护的交互模块;
4. 不适合抽取、与具体业务强绑定的页面区域。
请列出建议抽取的组件、使用页面和抽取理由。
暂时不要修改代码。
分析完成后,开发者需要判断哪些组件值得抽取。商品卡片就是一个比较典型的复用组件:它接收商品数据,通过统一的方式展示图片、名称和价格,并将点击事件交给页面处理。组件不应该直接决定点击后进入哪个页面,也不应该自行请求服务器获取商品信息。因为这些行为属于业务页面或数据服务的职责。
可以让 AI 按照这样的要求设计:
请将商品列表中重复使用的商品展示区域抽取为独立 ArkUI 组件。
组件要求:
1. 接收商品数据作为输入;
2. 支持展示商品图片、名称和价格;
3. 点击事件通过明确的回调交给外部页面;
4. 不直接调用网络接口;
5. 不直接控制页面路由;
6. 不保存与展示无关的业务状态;
7. 遵循当前工程的 ArkTS 类型和 ArkUI 组件规范。
请先给出组件属性和事件接口设计,再实现代码。
在 ArkUI 中,组件的属性和事件设计尤其重要。组件接收什么数据、是否允许某些字段为空、点击事件如何向外传递,都需要有清晰的约定。AI 如果没有明确的约束,可能会生成一个依赖全局变量、直接读取页面状态的组件。这样的组件虽然可以在当前页面运行,但换到其他页面就很难使用。
组件抽取后,还需要检查它是否真的能够复用。可以让 AI 在另一个页面中接入同一个商品卡片组件,验证它是否能够在不修改组件内部代码的情况下展示不同数据。如果为了适配新页面,不断向组件增加专属判断和特殊参数,就说明组件边界可能设计得不够合理。
除了业务组件,还可以考虑建立基础 UI 组件,例如统一按钮、加载状态、空状态和错误提示。这些组件通常具有较高的复用价值,但也不应该为了统一而过度抽象。例如,两个按钮虽然颜色相同,但一个用于提交订单,一个用于删除数据,它们的交互语义和风险不同。组件库可以统一视觉规范,但业务行为仍然应该由具体页面决定。
组件库建立之后,建议让 AI 根据项目实际结构整理一份组件使用说明,包括组件名称、用途、输入属性、事件回调和适用场景。这样,新页面开发时,开发者可以先让 AI 检查现有组件库,优先复用已有组件,而不是重新生成一套相似代码。
还可以将组件复用要求写进日常开发提示词:
在开发新页面之前,请先检查当前项目已有的 ArkUI 组件。
如果存在满足需求的组件:
- 优先复用;
- 不重复创建相同功能;
- 不擅自修改已有组件的公共接口。
如果确实需要新增组件:
- 说明新增原因;
- 明确组件职责;
- 定义输入属性和事件回调;
- 避免依赖具体业务页面;
- 提供至少一个实际使用示例。
最后,组件库需要经过持续验证。除了检查能否编译,还要检查不同数据长度、图片缺失、文字过长、不同页面布局和连续点击等情况。尤其是商品卡片这类展示组件,数据内容稍有变化就可能出现布局错位。
AI Coding 可以帮助开发者快速发现重复 UI、抽取组件和生成使用文档,但组件库是否合理,最终取决于开发者对业务边界的判断。不要为了追求组件数量而拆分,也不要让一个组件承担过多职责。把真正稳定、重复、具有明确边界的 UI 交给 AI 整理,才能让 HarmonyOS 项目逐步形成可复用、可维护的组件体系。
序观
我还没有写个人简介......
帖子
提问
粉丝
用 AI Coding 实现 HarmonyOS 本地数据管理:从简单存储到数据模型设计
2026-11-10 17:52:01 发布用 AI Coding 给 HarmonyOS 应用增加多设备适配能力,先从布局分析开始
2026-11-10 17:49:50 发布



0
京公网安备:11010502051901号