onLoad 不触发是因为未通过 uni-app 注册通道，必须 import { onLoad } from '@dcloudio/uni-app' 并调用 onLoad(() => {})，它专用于接收路由参数，非 Vue3 限制，且仅页面级有效。
onLoad 不触发，根本不是 Vue3 的锅，而是没走 uni-app 的注册通道——它压根没被框架识别为生命周期函数。
为什么 setup 里直接写 onLoad 函数就失效
在 <script setup> 中声明一个叫 onLoad 的普通函数（比如 function onLoad() {}），uni-app 运行时完全看不到它。框架只认一种注册方式：从 @dcloudio/uni-app 导入并调用。这不是 Vue3 的限制，是 uni-app 自己的生命周期挂载机制决定的。
常见错误包括：
- 把
onLoad当作 Vue 原生钩子，在setup里当普通函数定义 - 漏写
import { onLoad } from '@dcloudio/uni-app' - 写了导入但没调用，比如只写了
import { onLoad }却没写onLoad(() => {})
onLoad 必须用导入 + 调用的方式注册
正确写法只有一种：先导入，再以函数形式传入回调。参数是路由 query 对象，不是字符串。
立即学习“前端免费学习笔记（深入）”；
示例：
import { onLoad } from '@dcloudio/uni-app'
onLoad((options) => {
console.log('获取到参数：', options.id) // ✅ 正确取 id
// 这里可以发起请求、赋值 ref 等
})
注意点：
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
-
onLoad回调里访问this是undefined，所有状态必须用ref/reactive管理 - 不能在回调里直接给
data字段赋值（Vue2 写法残留），要操作ref或用getCurrentInstance()获取实例（不推荐） - 如果需要在
onLoad后立刻响应式更新视图，确保你修改的是响应式变量，而不是普通对象属性
和 onMounted 混用时的典型陷阱
onLoad 和 onMounted 触发时机不同、目的也不同：onLoad 专用于接收路由参数并做初始化；onMounted 是 Vue 层级的挂载完成钩子，此时 DOM 已就绪，但路由参数可能还没来（尤其 H5 下有微小延迟）。
容易出问题的场景：
- 在
onMounted里读route.params.id—— H5 下可能为空，因为 uni-app 的路由解析还没完成 - 把数据请求逻辑全塞进
onMounted，导致小程序里拿不到options，或 H5 下参数丢失 - 以为
onLoad会等onMounted之后才执行，实际上它更早，且不依赖 Vue 实例创建完成
稳妥做法：路由参数相关逻辑只放在 onLoad 回调里；DOM 相关操作（如 focus input、滚动定位）放 onMounted。
组件内无法使用 onLoad？那是设计如此
自定义组件（.vue 文件非页面）里写 onLoad 一定不生效——因为 onLoad 是页面级生命周期，组件不参与路由跳转和参数解析。
如果你在组件里需要感知页面加载，有两个选择：
- 让父页面在
onLoad后通过 props 或事件把参数透传进来 - 在组件中使用
pageLifetimes（需显式声明），但注意它不提供onLoad，只有show/hide等
漏写 pageLifetimes: { show() {} } 包裹，而直接在组件里写 onShow() {}，是高频静默失败原因。
最常被忽略的一点：跨端时 onLoad 的参数结构一致，但 H5 下若用 uni.navigateTo 带 hash 路由（如 /pages/detail/detail#id=123），options 里不会自动解析 hash，得自己处理 window.location.hash。
