unix-router v0.1.0 首发:uni-app x 的 vue-router 风格路由库

发布日期:2026-09-05

unix-router 首个可运行版本正式发布!这是一个为 uni-app x 提供的、API 对标 vue-router 4 的路由管理库,以 UTS 源码(.uts)随 uni_modules 分发,无需预编译,由 uni-app x 编译链按平台现场编译------Web / 小程序 → JS,Android → Kotlin,iOS → Swift。

为什么需要它

uni-app x 原生提供 uni.navigateTo / redirectTo / reLaunch / navigateBack / switchTab,但当页面增多后,「无路由表、无守卫、无统一路由状态、参数传递繁琐」成为痛点。unix-router 用一套与 vue-router 一致的 API 抹平这些差异,并提供登录鉴权、导航控制、参数传递等能力。

核心特性

  • vue-router 风格 API :createRouter、push / replace / relaunch / back,自动根据 meta.isTab 切换 switchTab
  • 路由匹配 :path / name 双索引,字符串 / 对象 / 命名三种解析,strict 严格模式
  • 路由守卫 :beforeEach / beforeResolve / afterEach / beforeEnter / 组件内守卫(onBeforeRouteLeave / onBeforeRouteUpdate / onBeforeRouteEnter),支持重定向与守卫超时
  • 组合式 API :useRouter() / useRoute() / useLink(),响应式 currentRoute
  • 参数传递 :params(Map<string,string>)经查询编码(__unixr_p_ 保留前缀)跨页传递,不暴露明文键名;query 以字符串经 URL 传递
  • 导航控制 :重复导航自动拒绝(DUPLICATED)、并发导航自动排队
  • 错误体系 :RouterError / NavigationFailure / RouterErrorCode,isNavigationFailure() 精准判断,onError 全局捕获
  • 状态同步 :页面 onShow 自动 syncRoute(),基于 getCurrentPages() 对齐物理返回 / TabBar 切换等非路由器导航

快速开始

typescript 复制代码
// 定义路由配置(path 与 pages.json 一致)
export const routes: RouteConfig[] = [
	{ path: 'pages/index/index', name: 'home', meta: { title: '首页', isTab: true } },
	{ path: 'pages/about/about', name: 'about', meta: { title: '关于', requireAuth: true } }
]

// 创建并安装路由器
export const router = createRouter({ routes, strict: true })
app.use(router) // 注入全局 mixin,onShow 自动 syncRoute()

// 页面内导航
const router = useRouter()
await router.push({ name: 'about', query: new Map([['id', '1']]) })

安装方式

  • uni-app 插件市场 :直接在 插件市场 中点击"使用 HBuilderX 导入"即可,项目内路径为 @/uni_modules/ux-router/utssdk/index.uts

文档

从入门到精通 的完整文档(🟢 入门 → 🟡 进阶 → 🔴 精通)位于 packages/docs,覆盖快速开始、路由配置、导航、守卫与完整实战示例。

平台兼容性

  • Web / H5、微信小程序 → 编译为 JS
  • App-Android → 编译为 Kotlin / JS
  • iOS(VDOM)→ 编译为 Swift
  • 底层仅依赖 uni.* 原生导航 API,双模式兼容 uni-app x

后续规划

  • 更丰富的守卫能力与冷启动守卫 guardRoute()
  • 面向实战的完整演示与性能优化

欢迎使用与反馈:uni-app 插件市场

相关推荐
Mh12 小时前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳13 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔13 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart14 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt15 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑15 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星16 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson16 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼17 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
七仔啊17 小时前
CNC计算机数控加工模拟器
前端