uniapp vue 页面生命周期 速查表 cheetsheet

UniApp 生命周期速查表

一、页面生命周期

函数名	触发时机	适用场景
onLoad	页面加载时触发，参数含启动参数	获取页面参数、初始化数据
onShow	页面每次显示时触发	刷新数据、处理界面逻辑
onReady	页面首次渲染完成时触发	DOM 操作等渲染后处理
onHide	页面隐藏时触发（如跳转、后台）	暂停操作、保存状态
onUnload	页面卸载时触发	清理定时器、取消订阅
onPullDownRefresh	用户下拉页面时触发	刷新页面内容
onReachBottom	页面触底时触发	加载更多数据
onPageScroll	页面滚动时触发	监听滚动位置变化
onShareAppMessage	用户点击分享按钮时触发	定制分享内容

二、组件生命周期

函数名	触发时机	适用场景
created	组件实例化时触发	初始化组件状态、数据请求
attached	组件挂载到页面时触发	DOM 操作、事件监听
ready	组件渲染完成后触发	获取元素尺寸等节点操作
moved	组件被移动到节点树时触发	处理位置变动逻辑
detached	组件从页面卸载时触发	清理资源（定时器、监听器）

三、全局生命周期

函数名	触发时机	适用场景
onLaunch	应用启动时触发	全局初始化、获取用户信息
onShow	应用每次显示时触发	应用从后台返回前台的处理
onHide	应用每次隐藏时触发	应用进入后台时暂停操作
onError	全局错误发生时触发	捕获并处理运行时错误
onPageNotFound	页面不存在时触发	自定义 404 页面、处理跳转失败

说明

• 生命周期函数会在组件 / 页面的特定阶段自动触发，无需手动调用

• 合理使用生命周期可提升应用性能，避免不必要的资源消耗

• 不同类型的生命周期（页面 / 组件 / 全局）作用域不同，需在对应位置定义

（注：文档部分内容可能由 AI 生成）