uni-app 官方不支持 pages.json 中的 routeAlias 或 aliasPath 等别名字段，这些是第三方插件或定制方案的扩展能力，原生框架编译时直接忽略；H5 端生效依赖插件劫持路由逻辑，小程序和 App 端因原生 SDK 严格校验路径而失效，多端统一别名需在 JS 层封装跳转函数并维护映射表。
uni-app 官方不支持 pages.json 中的页面别名（如 routeAlias 或 aliasPath），这些字段是第三方插件（如 uni-routealias）或定制化方案添加的扩展能力，**原生框架解析时会直接忽略**。如果你在 H5 端看到别名生效，那一定是插件在运行时劫持了路由逻辑；在小程序或 App 端则大概率失效。
pages.json 里加 routeAlias 字段为什么 H5 有反应但小程序没用
因为 routeAlias 不是 uni-app 标准字段，官方编译器（如 @dcloudio/uni-cli）压根不识别它。H5 端能跳转成功，通常是插件在 router.beforeEach 或 onLaunch 阶段做了路径映射：把 /mine 映射到 pages/profile/index；而小程序端的页面跳转由微信/支付宝原生 SDK 控制，uni.navigateTo({ url: '/mine' }) 会直接报错“页面不存在”。
-
routeAlias只对 H5 的 history.pushState / popstate 生效，依赖 JS 路由拦截 - 小程序的
url必须严格匹配pages.json中已注册的path值 - App 端行为取决于原生容器是否集成类似插件逻辑，绝大多数未集成
想让多端都支持别名，只能靠运行时映射
你得自己维护一个别名表，在跳转前做转换。推荐在 utils/router.js 封装统一跳转函数：
const aliasMap = {
'/mine': 'pages/profile/index',
'/post': 'pages/article/detail',
'/': 'pages/index/index'
}
export function navigateTo(url) {
const realPath = aliasMap[url] || url
uni.navigateTo({ url: realPath })
}
- 所有跳转必须走这个函数，不能直接调
uni.navigateTo({ url: '/mine' }) - 需要同时处理
onLoad参数透传 —— 别名本身不带 query，但真实页面可能需要接收参数 - 如果用了分包，
realPath必须是完整路径（含分包前缀），否则非主包页面会找不到
pages.json 中的 aliasPath 是什么？它和 routeAlias 有区别吗
像 aliasPath: '/' 这种写法，常见于某些团队内部 fork 的 uni-app 编译器或自定义构建脚本，并非标准配置。它的作用仅限于：当项目打包为小程序时，把该页面设为“首页入口”，等价于把该项移到 pages 数组第一位。它不会产生额外路由别名，也不影响跳转 URL。
-
aliasPath是非标准字段，只被特定构建工具读取，uni-app 官方 CLI 不识别 - 它和
routeAlias一样，都不参与实际路由匹配，只是辅助开发理解或控制首页逻辑 - 若误以为设置了
aliasPath就能在 JS 中用uni.navigateTo({ url: '/xxx' })跳转，必然失败
真正可靠的别名机制，必须在 JS 层统一收口、显式映射、覆盖全平台跳转路径 —— 没有配置文件捷径可走。尤其要注意分包路径拼接、query 参数保留、以及 onShow/onLoad 生命周期中 path 解析的一致性。
