HarmonyOS 页面生命周期完整梳理:aboutToAppear、onPageShow、onPageHide 别再混着用

系列:HarmonyOS 开发入门 · 05

HarmonyOS 生命周期最容易踩坑的地方,不是回调太多,而是不同层级的生命周期名字很像。

组件有组件生命周期,页面有页面生命周期;换成 Navigation 后,NavDestination 又有自己的一套页面生命周期。

如果全部当成"页面出现了"来用,接口请求很容易重复触发。

1. 先分清:组件生命周期和页面生命周期

普通 ArkUI 自定义组件常见:

ts 复制代码
aboutToAppear()
aboutToDisappear()

页面入口组件还可以关注:

ts 复制代码
onPageShow()
onPageHide()
onBackPress()

两组不是一回事。

2. aboutToAppear 什么时候触发

aboutToAppear 是组件级生命周期。

自定义组件实例创建后、build() 执行前会触发。

ts 复制代码
@Component
struct UserCard {
  aboutToAppear() {
    console.info('UserCard aboutToAppear')
  }

  build() {
    Text('User')
  }
}

它适合做与"组件创建"绑定的轻量初始化。

但如果这个组件在列表里出现 100 次,那它也可能创建很多次。所以不要看到 aboutToAppear 就塞网络请求。

3. onPageShow 才是页面显示语义

对于 @Entry 页面:

ts 复制代码
onPageShow() {
  console.info('page show')
}

onPageHide() {
  console.info('page hide')
}

页面从其他页面返回、应用从后台回到前台等场景,都可能触发 onPageShow。

因此它更适合:

  • 页面每次重新可见时刷新;
  • 回到前台后重新检查状态;
  • 刷新可能被其他页面修改的数据。

但它不等于"只执行一次"。

4. 首次进入时大概发生什么

一个简单页面首次创建时,可以理解成:

text 复制代码
aboutToAppear
↓
build
↓
页面展示
↓
onPageShow

如果还有子组件,子组件也会走自己的创建生命周期。

所以把初始化同时写在 aboutToAppear 和 onPageShow,非常容易执行两遍。

5. 页面切到后台

应用进入后台时,当前页面通常会收到隐藏相关回调,但组件本身未必被销毁。

这点很重要:

"看不见"不等于"被销毁"。

因此资源释放要区分:

  • 页面暂时不可见;
  • 组件真正销毁。

比如暂停一个页面动画,可以放在页面隐藏时;注销只属于组件实例的监听,则更适合在销毁时处理。

6. aboutToDisappear 不适合再改状态

组件即将销毁时,做清理是合理的:

ts 复制代码
aboutToDisappear() {
  // 注销监听、释放当前组件资源
}

但不要在这里继续修改会触发 UI 更新的状态变量。

组件都准备离开组件树了,再发起一轮状态刷新通常没有意义,还可能引发不稳定行为。

7. 一个常见错误:接口请求两次

假设你写了:

ts 复制代码
aboutToAppear() {
  this.loadData()
}

onPageShow() {
  this.loadData()
}

首屏就可能请求两次。

更合理的方式是先明确业务:

只在首次创建加载

放在组件创建语义中,并确保组件不会频繁被重新创建。

每次返回页面都刷新

使用页面展示语义。

首次加载一次,后续按条件刷新

增加状态控制:

ts 复制代码
@State hasLoaded: boolean = false

onPageShow() {
  if (!this.hasLoaded) {
    this.hasLoaded = true
    this.loadData()
    return
  }

  this.refreshIfNeeded()
}

现在新项目更推荐使用 Navigation + NavPathStack。

这时页面通常以 NavDestination 为核心,页面显示、隐藏、销毁会有更明确的 Navigation 生命周期事件。

所以如果项目已经全面使用 Navigation,不建议继续拿旧的页面路由思路硬套。

我后面会单独用一篇文章讲 NavDestination 生命周期。

9. 我的实际建议

写生命周期代码前先问三个问题:

  1. 这是"组件创建"还是"页面重新可见"?
  2. 这段逻辑需要执行一次还是每次都执行?
  3. 页面隐藏时只是暂停,还是要真正释放?

这三个问题想清楚,生命周期代码基本不会乱。

总结

最容易记的一句话:

aboutToAppear 关注组件创建,onPageShow 关注页面再次可见。

下一篇再往上一层,聊 UIAbility 生命周期。它和页面生命周期不是替代关系,而是应用组件层级更高的一套机制。

相关推荐
GitCode官方14 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追15 小时前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追19 小时前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos
jianqiang.xue19 小时前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai
程序猿追1 天前
鸿蒙 PC 用 Tauri 迁移配置文件,先保留旧版再写新版
华为·harmonyos
码间留白2 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农2 天前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos
我闪了个去2 天前
一个 Scroll 撑起整个首页:HarmonyOS 7 懒加载布局把网格、瀑布流、吸顶分组装进一次滚动
harmonyos·arkts