深入剖析 meng-xi/uni-router 的内部架构探讨在 uni-app 静态页面模型下实现 vue-router 风格路由管理的设计决策与工程实践为什么需要又一个路由库uni-app 的路由本质上是静态页面模型——所有页面在pages.json中声明运行时通过uni.navigateTo/uni.redirectTo/uni.navigateBack三个命令式 API 进行页面切换。这个模型简单直接但随着业务复杂度增长几个核心问题反复出现没有拦截点。登录校验、权限检查、页面标题设置……这些横切关注点不得不散落在每个页面的onShow或onLoad中。十个需要登录的页面就写十遍相同的判断逻辑。没有路由抽象。路径字符串硬编码在各处页面路径变更时需要全局搜索替换。没有命名路由没有元信息没有路由解析。没有错误体系。uni.navigateTo的fail回调只告诉你失败了但无法区分是页面不存在、栈溢出还是其他原因。更无法在全局统一处理导航错误。meng-xi/uni-router的设计目标不是替代pages.json而是在其之上构建一层可控的导航管理层提供守卫链、路由解析、状态同步和错误处理能力。架构总览整个框架由六个核心模块组成各司其职┌─────────────────────────────────────────────┐ │ UniRouter │ │ (门面 / 编排层) │ │ push / replace / back / install / syncRoute │ ├──────────┬──────────┬──────────┬─────────────┤ │ Matcher │ Guard │ State │ Interceptor │ │ 路由匹配 │ 守卫管理 │ 状态管理 │ API 拦截 │ ├──────────┴──────────┴──────────┴─────────────┤ │ Navigation │ │ uni API 适配层 │ ├──────────────────────────────────────────────┤ │ Errors │ │ 错误体系 (RouterError / │ │ NavigationFailure) │ └──────────────────────────────────────────────┘UniRouter是门面类对外暴露push/replace/back等方法对内编排 Matcher、Guard、State、Navigation 四个模块的协作流程。Matcher负责路由解析——将string、{ path, query }、{ name, query }三种形式的路由位置统一解析为RouteLocation对象。Guard负责守卫链的注册与执行——管理beforeEach、beforeResolve、afterEach三类全局守卫和beforeEnter路由独享守卫。State负责路由状态管理——维护currentRoute处理就绪状态和路由变化监听。Interceptor负责拦截 uni 原生导航 API——将外部直接调用重定向到路由器确保守卫始终生效。Navigation是 uni API 适配层——封装uni.navigateTo等为 Promise处理 TabBar 页面自动切换。Errors定义了完整的错误体系——RouterError基类和NavigationFailure子类携带错误码、来源/目标路由和原始错误。导航流程一次 push 的完整旅程当调用router.push({ name: about, query: { id: 1 } })时框架内部经历了以下步骤1. 并发导航排队privateasyncperformNavigation(location:RouteLocationRaw,mode:push|replace){// 等待前一次导航完成if(this.pendingNavigation){awaitthis.pendingNavigation.catch((){})}// ...constnavigationPromisethis.executeNavigation(to,from,mode,0)this.pendingNavigationnavigationPromise// ...}uni-app 的页面导航是异步的如果两次push同时执行可能导致页面栈混乱。框架通过pendingNavigation实现导航排队——新的导航必须等待前一次完成后再开始。catch(() {})确保即使前一次导航失败也不会阻塞后续导航。2. 重复导航检测if(modepushthis.isSameRouteLocation(to,from)){constfailurenewNavigationFailure(to,from,RouterErrorCode.NAVIGATION_DUPLICATED,...)returnPromise.reject(failure)}push到当前已处于的页面是无意义的操作replace允许因为可能只是查询参数不同。路径和查询参数完全一致时直接 reject 并携带NAVIGATION_DUPLICATED错误码。3. 守卫链执行这是导航流程中最复杂的部分涉及四层守卫的顺序执行和重定向处理beforeEach → beforeEnter → beforeResolve → uni API → afterEach每一层守卫都可能产生三种结果next() 调用GuardResult后续行为next(){ type: next }继续执行下一层守卫next(false){ type: abort, code: NAVIGATION_ABORTED }中止导航rejectnext({ path: /login }){ type: next, redirect: { path: /login } }递归执行重定向导航守卫的核心难点在于回调风格到 Promise 风格的转换。vue-router 的守卫使用next()回调但内部流程是异步的。框架通过runGuard函数将回调风格统一转换为PromiseGuardResultfunctionrunGuard(guard:NavigationGuard,to:RouteLocation,from:RouteLocation):PromiseGuardResult{returnnewPromise(resolve{letresolvedfalseconstnext:NavigationGuardNext(location?){if(resolved)return// 防止多次调用 nextresolvedtrueif(locationfalse)resolve({type:abort,code:NAVIGATION_ABORTED})elseif(location)resolve({type:next,redirect:location})elseresolve({type:next})}// 守卫抛异常视为中止try{constresultguard(to,from,next)// 支持异步守卫if(result?.catch)result.catch((){if(!resolved)resolve({type:abort,...})})}catch{if(!resolved)resolve({type:abort,...})}})}resolved标志位防止next()被多次调用。守卫既可以是同步的也可以返回 Promise异步守卫两种情况都被正确处理。4. 重定向与深度限制守卫重定向本质上是递归执行导航流程privatehandleGuardResult(result,to,from,mode,redirectDepth){if(result.redirect){constredirectTargetthis.matcher.resolve(result.redirect)returnthis.executeNavigation(redirectTarget,from,mode,redirectDepth1)}// ...}但递归有风险——如果守卫 A 重定向到 BB 的守卫又重定向到 A就会无限循环。框架通过MAX_REDIRECT_DEPTH 10限制重定向深度超过后抛出NAVIGATION_CANCELLED错误。5. uni API 调用守卫全部通过后进入实际的页面跳转constnavOptions{path:to.path,meta:to.meta,query:to.query}if(modepush)awaitnavigateTo(navOptions)elseawaitreplaceTo(navOptions)navigateTo和replaceTo内部根据meta.isTab自动选择uni.navigateTo/uni.switchTab或uni.redirectTo/uni.switchTabexportfunctionnavigateTo(options:UniNavigationOptions):Promisevoid{const{path,meta,query}optionsif(meta.isTab){// switchTab 不支持查询参数给出警告if(hasQueryParams(query))warn(uni.switchTab does not support query parameters.)returnuniSwitchTab(path)}returnuniNavigateTo(path,query)}所有 uni API 调用都被promisify化统一返回 Promise。失败时封装为UniApiError携带 API 名称和原始错误。6. 状态更新与后置钩子导航 API 调用成功后this.routeState.setCurrentRoute(to)this.guardManager.runAfterGuards(to,from)setCurrentRoute会对路由对象进行深度冻结Object.freeze确保路由状态不可变——任何组件拿到的currentRoute都不会被意外修改。路由匹配器三种定位方式的统一解析Matcher 维护两个索引pathMap路径 → 配置和nameMap名称 → 配置支持三种路由位置输入// 1. 字符串路径可含查询参数router.push(/pages/about/index?id1)// 2. 路径对象router.push({path:/pages/about/index,query:{id:1}})// 3. 命名路由router.push({name:about,query:{id:1}})三种输入最终都被解析为统一的RouteLocationinterfaceRouteLocation{path:string// 标准化后的路径如 /pages/about/indexname?:string// 路由名称meta:RouteMeta// 路由元信息query:Recordstring,string// 查询参数fullPath:string// 完整路径如 /pages/about/index?id1}路径标准化normalizePath确保/pages/about/index、pages/about/index、/pages/about/index/都指向同一路由。严格模式strict: true下命名路由找不到时抛出ROUTE_NOT_FOUND非严格模式下仅输出警告并降级为路径导航。状态同步uni-app 页面栈与路由器的博弈这是 uni-app 路由管理中最棘手的问题。uni-app 的页面栈由运行时管理路由器的currentRoute是应用层状态——两者可能不同步。不同步的场景浏览器后退H5 平台用户点击浏览器后退按钮页面实际回退了但路由器不知道物理返回键App 平台Android 返回键触发navigateBack路由器未感知第三方代码直接调用uni.navigateTo绕过路由器守卫未执行syncRoute 的设计syncRoute():void{constfromthis.routeState.getCurrentRoute()constcurrentPathgetCurrentPagePath()// 从 uni 页面栈读取if(currentPathfrom.path)return// 已同步无需操作this.syncCurrentRoute(from)// 读取实际页面信息并更新}getCurrentPagePath()通过getCurrentPages()获取 uni-app 实际页面栈的栈顶页面路径。如果与路由器状态不一致就从页面栈中读取路径、元信息和查询参数更新currentRoute并触发afterEach后置钩子。建议在每个页面的onShow中调用syncRoute()因为onShow在页面从后台回到前台时也会触发覆盖了浏览器后退和物理返回键的场景。API 拦截让 uni.navigateTo 也走路由守卫interceptUniApi: true选项启用后直接调用uni.navigateTo等原生 API 也会经过路由守卫。实现原理是uni.addInterceptoruni.addInterceptor(navigateTo,{invoke(args){if(_isRouterCall){_isRouterCallfalse// 路由器内部调用放行returnargs}// 外部调用转由路由器处理handleInterceptedNavigation(navigateTo,args)returnfalse// 阻止原始调用}})关键设计是内部标记_isRouterCall。路由器自身调用uni.navigateTo时先通过markRouterCall()设置标记拦截器检测到标记后放行避免守卫链被重复执行。错误体系可编程的导航失败处理框架定义了两层错误类RouterError (基类) ├── code: RouterErrorCode // 错误码 └── message: string // 错误信息自动添加 [uni-router] 前缀 NavigationFailure (子类) ├── to: RouteLocation // 目标路由 ├── from: RouteLocation // 来源路由 └── cause?: unknown // 原始错误仅 API 调用失败时错误码枚举错误码触发场景NAVIGATION_ABORTED守卫调用next(false)NAVIGATION_CANCELLED重定向深度超限NAVIGATION_DUPLICATEDpush 到当前页面ROUTE_NOT_FOUND严格模式下命名路由不存在NAVIGATION_API_ERRORuni API 调用失败SETUP_ERRORuseRouter() 在 setup 外调用双重错误处理机制// 1. 全局错误处理器——适合统一上报、日志router.onError((error,to,from){analytics.track(navigation_error,{code:error.code,from:from.path,to:to.path})})// 2. 局部 try/catch——适合 UI 反馈try{awaitrouter.push({name:protected})}catch(e){if(e.codeNAVIGATION_ABORTED){showToast(您没有访问权限)}}Vue 插件集成与 uni-app H5 的 vue-router 共存H5 平台上uni-app 内部使用了 vue-router会在全局属性上注册$router和$route。直接覆盖会导致 uni-app 路由功能异常。框架的install方法采用了防御性设计install(app):void{// 通过 provide/inject 提供路由器useRouter / useRoute 使用vueApp.provide(ROUTER_SYMBOL,this)// 仅在 $router 未被定义时设置全局属性if(!($routerinvueApp.config.globalProperties)){vueApp.config.globalProperties.$routerthis}if(!($routeinvueApp.config.globalProperties)){Object.defineProperty(vueApp.config.globalProperties,$route,{get:()this.currentRoute})}}优先使用provide/inject机制useRouter()/useRoute()全局属性作为降级方案。$route使用 getter 定义确保每次访问都返回最新的路由状态。设计取舍在实现过程中有几个关键的设计取舍值得讨论为什么不实现动态路由vue-router 支持运行时router.addRoute()/router.removeRoute()但 uni-app 的页面注册是静态的——pages.json在编译期确定运行时无法添加新页面。动态路由在 uni-app 中没有意义因此未实现。为什么守卫使用回调风格而非纯 Promise兼容 vue-router 的 API 习惯。vue-router 的守卫使用next()回调大量教程和代码示例基于此风格。框架内部将回调转换为 Promise但对外保持回调接口。为什么 syncRoute 需要手动调用自动监听页面变化需要轮询getCurrentPages()性能开销不可接受。onShow是 uni-app 提供的页面可见性回调在合适的时机调用syncRoute()是成本最低的方案。为什么拦截器使用标记而非调用栈分析uni-app 的addInterceptor是全局的无法区分调用来源。调用栈分析new Error().stack性能差且不可靠。简单的布尔标记是最轻量的解决方案。写在最后meng-xi/uni-router的核心设计哲学是在 uni-app 的约束下提供最大程度的路由管理能力。不替代pages.json不破坏原生页面模型而是在其之上构建守卫链、路由解析和错误处理层。每一个设计决策都围绕与 uni-app 共存这个前提展开。如果你对实现细节感兴趣源码位于 GitHub欢迎阅读和贡献。
uni-app静态页面模型下的vue-router风格路由管理
发布时间:2026/6/9 7:49:34
深入剖析 meng-xi/uni-router 的内部架构探讨在 uni-app 静态页面模型下实现 vue-router 风格路由管理的设计决策与工程实践为什么需要又一个路由库uni-app 的路由本质上是静态页面模型——所有页面在pages.json中声明运行时通过uni.navigateTo/uni.redirectTo/uni.navigateBack三个命令式 API 进行页面切换。这个模型简单直接但随着业务复杂度增长几个核心问题反复出现没有拦截点。登录校验、权限检查、页面标题设置……这些横切关注点不得不散落在每个页面的onShow或onLoad中。十个需要登录的页面就写十遍相同的判断逻辑。没有路由抽象。路径字符串硬编码在各处页面路径变更时需要全局搜索替换。没有命名路由没有元信息没有路由解析。没有错误体系。uni.navigateTo的fail回调只告诉你失败了但无法区分是页面不存在、栈溢出还是其他原因。更无法在全局统一处理导航错误。meng-xi/uni-router的设计目标不是替代pages.json而是在其之上构建一层可控的导航管理层提供守卫链、路由解析、状态同步和错误处理能力。架构总览整个框架由六个核心模块组成各司其职┌─────────────────────────────────────────────┐ │ UniRouter │ │ (门面 / 编排层) │ │ push / replace / back / install / syncRoute │ ├──────────┬──────────┬──────────┬─────────────┤ │ Matcher │ Guard │ State │ Interceptor │ │ 路由匹配 │ 守卫管理 │ 状态管理 │ API 拦截 │ ├──────────┴──────────┴──────────┴─────────────┤ │ Navigation │ │ uni API 适配层 │ ├──────────────────────────────────────────────┤ │ Errors │ │ 错误体系 (RouterError / │ │ NavigationFailure) │ └──────────────────────────────────────────────┘UniRouter是门面类对外暴露push/replace/back等方法对内编排 Matcher、Guard、State、Navigation 四个模块的协作流程。Matcher负责路由解析——将string、{ path, query }、{ name, query }三种形式的路由位置统一解析为RouteLocation对象。Guard负责守卫链的注册与执行——管理beforeEach、beforeResolve、afterEach三类全局守卫和beforeEnter路由独享守卫。State负责路由状态管理——维护currentRoute处理就绪状态和路由变化监听。Interceptor负责拦截 uni 原生导航 API——将外部直接调用重定向到路由器确保守卫始终生效。Navigation是 uni API 适配层——封装uni.navigateTo等为 Promise处理 TabBar 页面自动切换。Errors定义了完整的错误体系——RouterError基类和NavigationFailure子类携带错误码、来源/目标路由和原始错误。导航流程一次 push 的完整旅程当调用router.push({ name: about, query: { id: 1 } })时框架内部经历了以下步骤1. 并发导航排队privateasyncperformNavigation(location:RouteLocationRaw,mode:push|replace){// 等待前一次导航完成if(this.pendingNavigation){awaitthis.pendingNavigation.catch((){})}// ...constnavigationPromisethis.executeNavigation(to,from,mode,0)this.pendingNavigationnavigationPromise// ...}uni-app 的页面导航是异步的如果两次push同时执行可能导致页面栈混乱。框架通过pendingNavigation实现导航排队——新的导航必须等待前一次完成后再开始。catch(() {})确保即使前一次导航失败也不会阻塞后续导航。2. 重复导航检测if(modepushthis.isSameRouteLocation(to,from)){constfailurenewNavigationFailure(to,from,RouterErrorCode.NAVIGATION_DUPLICATED,...)returnPromise.reject(failure)}push到当前已处于的页面是无意义的操作replace允许因为可能只是查询参数不同。路径和查询参数完全一致时直接 reject 并携带NAVIGATION_DUPLICATED错误码。3. 守卫链执行这是导航流程中最复杂的部分涉及四层守卫的顺序执行和重定向处理beforeEach → beforeEnter → beforeResolve → uni API → afterEach每一层守卫都可能产生三种结果next() 调用GuardResult后续行为next(){ type: next }继续执行下一层守卫next(false){ type: abort, code: NAVIGATION_ABORTED }中止导航rejectnext({ path: /login }){ type: next, redirect: { path: /login } }递归执行重定向导航守卫的核心难点在于回调风格到 Promise 风格的转换。vue-router 的守卫使用next()回调但内部流程是异步的。框架通过runGuard函数将回调风格统一转换为PromiseGuardResultfunctionrunGuard(guard:NavigationGuard,to:RouteLocation,from:RouteLocation):PromiseGuardResult{returnnewPromise(resolve{letresolvedfalseconstnext:NavigationGuardNext(location?){if(resolved)return// 防止多次调用 nextresolvedtrueif(locationfalse)resolve({type:abort,code:NAVIGATION_ABORTED})elseif(location)resolve({type:next,redirect:location})elseresolve({type:next})}// 守卫抛异常视为中止try{constresultguard(to,from,next)// 支持异步守卫if(result?.catch)result.catch((){if(!resolved)resolve({type:abort,...})})}catch{if(!resolved)resolve({type:abort,...})}})}resolved标志位防止next()被多次调用。守卫既可以是同步的也可以返回 Promise异步守卫两种情况都被正确处理。4. 重定向与深度限制守卫重定向本质上是递归执行导航流程privatehandleGuardResult(result,to,from,mode,redirectDepth){if(result.redirect){constredirectTargetthis.matcher.resolve(result.redirect)returnthis.executeNavigation(redirectTarget,from,mode,redirectDepth1)}// ...}但递归有风险——如果守卫 A 重定向到 BB 的守卫又重定向到 A就会无限循环。框架通过MAX_REDIRECT_DEPTH 10限制重定向深度超过后抛出NAVIGATION_CANCELLED错误。5. uni API 调用守卫全部通过后进入实际的页面跳转constnavOptions{path:to.path,meta:to.meta,query:to.query}if(modepush)awaitnavigateTo(navOptions)elseawaitreplaceTo(navOptions)navigateTo和replaceTo内部根据meta.isTab自动选择uni.navigateTo/uni.switchTab或uni.redirectTo/uni.switchTabexportfunctionnavigateTo(options:UniNavigationOptions):Promisevoid{const{path,meta,query}optionsif(meta.isTab){// switchTab 不支持查询参数给出警告if(hasQueryParams(query))warn(uni.switchTab does not support query parameters.)returnuniSwitchTab(path)}returnuniNavigateTo(path,query)}所有 uni API 调用都被promisify化统一返回 Promise。失败时封装为UniApiError携带 API 名称和原始错误。6. 状态更新与后置钩子导航 API 调用成功后this.routeState.setCurrentRoute(to)this.guardManager.runAfterGuards(to,from)setCurrentRoute会对路由对象进行深度冻结Object.freeze确保路由状态不可变——任何组件拿到的currentRoute都不会被意外修改。路由匹配器三种定位方式的统一解析Matcher 维护两个索引pathMap路径 → 配置和nameMap名称 → 配置支持三种路由位置输入// 1. 字符串路径可含查询参数router.push(/pages/about/index?id1)// 2. 路径对象router.push({path:/pages/about/index,query:{id:1}})// 3. 命名路由router.push({name:about,query:{id:1}})三种输入最终都被解析为统一的RouteLocationinterfaceRouteLocation{path:string// 标准化后的路径如 /pages/about/indexname?:string// 路由名称meta:RouteMeta// 路由元信息query:Recordstring,string// 查询参数fullPath:string// 完整路径如 /pages/about/index?id1}路径标准化normalizePath确保/pages/about/index、pages/about/index、/pages/about/index/都指向同一路由。严格模式strict: true下命名路由找不到时抛出ROUTE_NOT_FOUND非严格模式下仅输出警告并降级为路径导航。状态同步uni-app 页面栈与路由器的博弈这是 uni-app 路由管理中最棘手的问题。uni-app 的页面栈由运行时管理路由器的currentRoute是应用层状态——两者可能不同步。不同步的场景浏览器后退H5 平台用户点击浏览器后退按钮页面实际回退了但路由器不知道物理返回键App 平台Android 返回键触发navigateBack路由器未感知第三方代码直接调用uni.navigateTo绕过路由器守卫未执行syncRoute 的设计syncRoute():void{constfromthis.routeState.getCurrentRoute()constcurrentPathgetCurrentPagePath()// 从 uni 页面栈读取if(currentPathfrom.path)return// 已同步无需操作this.syncCurrentRoute(from)// 读取实际页面信息并更新}getCurrentPagePath()通过getCurrentPages()获取 uni-app 实际页面栈的栈顶页面路径。如果与路由器状态不一致就从页面栈中读取路径、元信息和查询参数更新currentRoute并触发afterEach后置钩子。建议在每个页面的onShow中调用syncRoute()因为onShow在页面从后台回到前台时也会触发覆盖了浏览器后退和物理返回键的场景。API 拦截让 uni.navigateTo 也走路由守卫interceptUniApi: true选项启用后直接调用uni.navigateTo等原生 API 也会经过路由守卫。实现原理是uni.addInterceptoruni.addInterceptor(navigateTo,{invoke(args){if(_isRouterCall){_isRouterCallfalse// 路由器内部调用放行returnargs}// 外部调用转由路由器处理handleInterceptedNavigation(navigateTo,args)returnfalse// 阻止原始调用}})关键设计是内部标记_isRouterCall。路由器自身调用uni.navigateTo时先通过markRouterCall()设置标记拦截器检测到标记后放行避免守卫链被重复执行。错误体系可编程的导航失败处理框架定义了两层错误类RouterError (基类) ├── code: RouterErrorCode // 错误码 └── message: string // 错误信息自动添加 [uni-router] 前缀 NavigationFailure (子类) ├── to: RouteLocation // 目标路由 ├── from: RouteLocation // 来源路由 └── cause?: unknown // 原始错误仅 API 调用失败时错误码枚举错误码触发场景NAVIGATION_ABORTED守卫调用next(false)NAVIGATION_CANCELLED重定向深度超限NAVIGATION_DUPLICATEDpush 到当前页面ROUTE_NOT_FOUND严格模式下命名路由不存在NAVIGATION_API_ERRORuni API 调用失败SETUP_ERRORuseRouter() 在 setup 外调用双重错误处理机制// 1. 全局错误处理器——适合统一上报、日志router.onError((error,to,from){analytics.track(navigation_error,{code:error.code,from:from.path,to:to.path})})// 2. 局部 try/catch——适合 UI 反馈try{awaitrouter.push({name:protected})}catch(e){if(e.codeNAVIGATION_ABORTED){showToast(您没有访问权限)}}Vue 插件集成与 uni-app H5 的 vue-router 共存H5 平台上uni-app 内部使用了 vue-router会在全局属性上注册$router和$route。直接覆盖会导致 uni-app 路由功能异常。框架的install方法采用了防御性设计install(app):void{// 通过 provide/inject 提供路由器useRouter / useRoute 使用vueApp.provide(ROUTER_SYMBOL,this)// 仅在 $router 未被定义时设置全局属性if(!($routerinvueApp.config.globalProperties)){vueApp.config.globalProperties.$routerthis}if(!($routeinvueApp.config.globalProperties)){Object.defineProperty(vueApp.config.globalProperties,$route,{get:()this.currentRoute})}}优先使用provide/inject机制useRouter()/useRoute()全局属性作为降级方案。$route使用 getter 定义确保每次访问都返回最新的路由状态。设计取舍在实现过程中有几个关键的设计取舍值得讨论为什么不实现动态路由vue-router 支持运行时router.addRoute()/router.removeRoute()但 uni-app 的页面注册是静态的——pages.json在编译期确定运行时无法添加新页面。动态路由在 uni-app 中没有意义因此未实现。为什么守卫使用回调风格而非纯 Promise兼容 vue-router 的 API 习惯。vue-router 的守卫使用next()回调大量教程和代码示例基于此风格。框架内部将回调转换为 Promise但对外保持回调接口。为什么 syncRoute 需要手动调用自动监听页面变化需要轮询getCurrentPages()性能开销不可接受。onShow是 uni-app 提供的页面可见性回调在合适的时机调用syncRoute()是成本最低的方案。为什么拦截器使用标记而非调用栈分析uni-app 的addInterceptor是全局的无法区分调用来源。调用栈分析new Error().stack性能差且不可靠。简单的布尔标记是最轻量的解决方案。写在最后meng-xi/uni-router的核心设计哲学是在 uni-app 的约束下提供最大程度的路由管理能力。不替代pages.json不破坏原生页面模型而是在其之上构建守卫链、路由解析和错误处理层。每一个设计决策都围绕与 uni-app 共存这个前提展开。如果你对实现细节感兴趣源码位于 GitHub欢迎阅读和贡献。