前言

随着 HarmonyOS NEXT 正式进入快速发展阶段，越来越多开发者开始接触 ArkTS 开发。

很多刚从 Java、Kotlin、Vue、React 转过来的开发者，经常会遇到这样的问题：

• 状态更新为什么不生效？
• @State 和 @Prop 到底有什么区别？
• 页面数据如何优雅传递？
• List 为什么会卡顿？
• 页面销毁后为什么内存没有释放？

本文结合实际项目经验，总结10个高频开发技巧，希望帮助大家快速提升鸿蒙开发效率。

1. 优先使用@Builder封装重复UI

很多新手喜欢复制粘贴代码：

Row() { Image($r('app.media.avatar')) .width(40) .height(40) Text('张三') }

如果项目里出现几十次：

@Builder UserItem(name: string) { Row() { Image($r('app.media.avatar')) .width(40) .height(40) Text(name) .margin({ left: 10 }) } }

调用：

this.UserItem("张三")

优势：

• 提高复用性
• 降低维护成本
• 提升代码可读性

2. List必须配置LazyForEach

错误写法：

ForEach(this.dataList,(item)=>{ ListItem(){ Text(item.name) } })

数据量超过500条时容易卡顿。

推荐：

LazyForEach( this.dataSource, (item) => { ListItem() { Text(item.name) } } )

原因：

LazyForEach采用懒加载机制。

只渲染当前可见区域。

企业项目基本标配。

3. 善用状态管理

很多同学分不清：

@State @Prop @Link @Provide @Consume

记住一个口诀：

页面内部：State 父传子：Prop 双向绑定：Link 跨层传递：Provide + Consume

实际开发中：

80%场景：

@State

15%场景：

@Prop @Link

5%场景：

@Provide @Consume

4. 网络请求统一封装

不要在页面中直接写：

axios.get(...)

推荐：

api/ ├── userApi.ts ├── orderApi.ts ├── goodsApi.ts

例如：

export function getUserInfo() { return request({ url:'/user/info', method:'GET' }) }

页面：

getUserInfo()

优点：

• 统一维护
• 方便切换接口
• 支持统一拦截器

5. 页面参数统一管理

跳转：

router.pushUrl({ url:'pages/Detail', params:{ id:1001 } })

接收：

let params = router.getParams()

推荐建立：

types/router.ts

统一定义参数类型。

避免大型项目参数混乱。

6. 图片资源不要全部放本地

很多项目把所有图片放：

resources

最终导致：

HAP包体积暴涨

推荐：

图标 -> 本地 商品图 -> OSS Banner -> CDN

企业项目基本如此。

启动速度更快。

7. Toast统一封装

不要每个页面都写：

promptAction.showToast({ message:'成功' })

统一：

Toast.show("成功")

后续切换样式无需修改业务代码。

8. 页面离开及时释放资源

例如：

Web组件 视频播放器 地图组件 定时器

页面退出：

aboutToDisappear() { clearInterval(this.timer) }

否则容易：

内存泄漏 页面卡顿 耗电增加

9. 善用TypeScript类型约束

不要：

let user:any

推荐：

interface User { id:number name:string age:number }

使用：

let user:User

好处：

• 自动提示
• 编译检查
• 降低Bug率

10. 建立项目统一目录规范

推荐企业级结构：

src │ ├── pages │ ├── components │ ├── api │ ├── utils │ ├── model │ ├── constants │ ├── common │ ├── router │ └── resources

这样即使项目达到：

100+ 页面 50+ 接口

依然容易维护。

企业项目开发建议

很多开发者刚接触鸿蒙时喜欢：

功能先实现再说

结果：

代码越来越乱 组件越来越难维护 项目越来越难扩展

正确思路应该是：

组件化 模块化 类型化 统一封装 统一规范

这也是目前大部分 HarmonyOS NEXT 企业项目采用的开发模式。

总结

ArkTS 并不难，真正难的是工程化思维。

掌握本文这10个开发技巧后，你会发现：

✅ 页面开发速度更快

✅ 代码结构更清晰

✅ 项目更容易维护

✅ 更接近企业级开发标准

对于刚入门 HarmonyOS NEXT 的开发者来说，与其学习大量零散知识，不如先养成良好的开发习惯。

因为真正拉开开发者差距的，往往不是会不会写页面，而是会不会写一个能长期维护的项目。