路由实例采用“状态机”模型,以idle和navigating等明确状态及严格转换条件描述生命周期:idle为初始待命态,接受导航调用并校验合法性;触发后进入navigating执行动画、加载与参数注入,期间禁止重复调用,失败则回退至idle。

路由实例的“状态机”模型,是一种用有限、明确的状态 + 清晰转换条件来描述路由行为的方式。它不靠一堆临时变量和嵌套 if 判断硬凑逻辑,而是把整个生命周期拆成几个关键阶段——每个阶段只做该做的事,状态之间切换有据可依,出问题也容易定位。
比如在导航类路由(如 HarmonyOS 的 Navigation 组件或某些嵌入式 UI 路由系统)中,“IDLE → NAVIGATING”不是随意跳转,而是一次受控的流程启动。
IDLE 状态:静默待命,不主动动作
这是路由实例的初始或空闲态。
- 没有正在执行的页面跳转、没有挂起的动画、也不持有目标页面上下文。
- 所有导航 API(如
pushPath、replaceDestination)调用在此状态下才被接受并触发后续流程。 - 类似于交通灯的“红灯”——车停着,但司机已握好方向盘,只等绿灯。
?注意:IDLE 不等于“没配置好”。它可以已加载路由表、已注册页面别名,只是尚未收到导航指令。
触发切换的关键事件:一次合法的导航调用
从 IDLE 进入 NAVIGATING,必须由一个明确的、可验证的导航请求驱动,例如:
-
navigation.pushPath('/settings') -
navigation.replaceDestination({ name: 'CameraPage', params: { mode: 'video' } }) - 用户点击带
routerLink的按钮(在支持声明式路由的框架中)
此时系统会:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 校验目标路径是否注册、参数是否合法、权限是否满足
- 预加载目标页面资源(如
.ets文件、组件模块) - 初始化导航上下文(如生成唯一
navId、记录来源栈深度) - 将内部状态标记为
NAVIGATING,并开始执行动效准备
NAVIGATING 状态:过程进行中,不可中断
进入此状态后,路由实例正式进入“执行通道”:
- 页面内容区开始淡出/滑动/缩放等过渡动画
- 标题栏同步更新标题与返回按钮状态
- 路由参数注入目标页面实例(如通过
getRouteParam()可读取) - 若启用共享元素动效,此时已锁定源/目标组件的 DOM 或渲染节点
⚠️ 重要约束:
- 在 NAVIGATING 期间,再次调用
pushPath会被暂存或拒绝(取决于实现策略),避免动画打架或栈错乱 - 若加载失败(如页面模块未找到、网络超时),通常会回退到 IDLE,并抛出错误事件供上层捕获
实际调试怎么看?
以 HarmonyOS ArkUI 为例,可通过日志或 DevTools 观察:
navigation.on('stateChange', (e) => {
console.info(`路由状态变为:${e.state}`); // e.state 可能是 'IDLE' | 'NAVIGATING' | 'NAVIGATED'
});
华为设备上也可用 hdc shell 查看当前导航栈快照,确认是否卡在 NAVIGATING 而无后续进展——这往往指向页面构造函数阻塞、异步资源未 resolve 或动效配置异常。
状态机的价值不在炫技,而在让“跳转”这件事变得可预测、可测试、可恢复。IDLE 是守门人,NAVIGATING 是施工队,两者之间那条触发线,就是你代码里最该盯紧的一行调用。










