梦曦i-CSDN博客

原创 Vite插件体系1.0.0：API稳定，生产就绪

@meng-xi/vite-plugin 1.0.0 正式发布，API 稳定，生产就绪。内含 15 个插件，按 7 大功能分组（构建分析、产物压缩等），14 个通用工具模块，支持子路径 Tree-shaking。从 0.2.7 平滑升级，无破坏性变更。回顾 0.x 系列从 2 个插件增长至 15 个的发展历程，为开发者提供覆盖构建全生命周期的稳定工具集。

2026-06-27 22:06:56 571

原创 uni-router v1.8.0新增冷启动守卫补执行

v1.8.0 新增 guardRoute() 方法，解决冷启动场景下守卫未执行问题（H5 地址栏、小程序场景值、App deeplink 等），可补执行守卫链；导出 UniApiError 与 UniApiCause 类型，NavigationFailure.cause 类型收紧为 UniApiError；守卫放行时不重复导航，重定向默认用 relaunch，中止触发 onAbort。增强权限控制与开发体验。

2026-06-27 00:15:34 783

原创 uni-app路由管理神器：vue-router风格体验

@meng-xi/uni-router 为 uni-app 提供类 vue-router 的路由管理，支持 push/replace/back 导航方法，自动适配 uni-app 原生 API。支持全局/路由独享的 beforeEach、beforeResolve、afterEach 守卫，便于实现登录拦截和权限控制。提供命名路由、meta 元信息、TypeScript 类型提示及 RouterLink 组件，兼容组合式 API（useRouter/useRoute）。

2026-06-07 19:27:59 710

原创 v2.7.0：H5 端导航动画扩展与 meta.animation 门控优化

v2.7.0 H5 端支持 CSS 过渡动画（push/back），与 App 端命名对齐；meta.animation 需注册 AnimationPlugin 才生效；重构 uni API 层，完全兼容升级。

2026-08-30 19:09:23 260

原创 v1.4.0：新增 defineUniPage 宏声明页面配置，架构全面重构

v1.4.0 新增 defineUniPage 宏声明页面配置，无需 import 且自动生成类型，优先级高于 <route-config>；架构重构统一串行生成，消除竞态；支持 JSONC。兼容升级。

2026-08-28 16:23:08 275

原创 v2.6.0 新增全局返回守卫与 iOS 侧滑拦截，补齐跨端路由拦截能力

v2.6.0 新增 onBeforeBack 全局返回守卫（App/H5），支持拦截与异步控制；新增 setSideSlipGesture 控制 iOS 侧滑手势；补全 getPlatform 工具。兼容升级。

2026-08-27 15:00:04 331

原创 @meng-xi/vite-plugin v1.3.0：generateUni 一键流水线

v1.3.0 新增 generateUni 组合插件，将 generatePages（生成 pages.json）与 generateRouter（生成路由配置）整合为一条自动化流水线，阶段一内存产出直接传递阶段二，无需重复读盘。配置按 pages/router 子对象分组，结构更清晰。同时修复生产构建中 <route-config> 虚拟模块被当作 JS 解析的报错，优化 proxyManager 构建开销，重构类型系统。完全向后兼容，插件总数增至 17 个。

2026-08-26 21:03:10 203

原创 Vite 1.2.0发布：自动生成pages.json

v1.2.0 新增 generatePages 插件，扫描 Vue 文件及 <route-config> 块自动生成 pages.json（含分包与 tabBar），支持入口固定、稳定排序、监听更新。与 generateRouter 联动形成自动化闭环，兼容升级，Vite 支持扩至 9.0。

2026-08-25 21:48:12 203

原创 RouterLink v2.5.0：H5端原生能力全面回归

v2.5.0 在 H5 端将 RouterLink 渲染为原生 <a> 标签并带真实 href，恢复了右键新标签页、悬停地址预览、无障碍支持等原生能力；App/小程序仍使用 <navigator>，行为不变。左键点击走路由器导航（守卫链生效），修饰键/中键保留浏览器默认行为。完全向后兼容，无需修改现有代码。

2026-08-23 23:11:03 210

原创 Vue-Router 2.4.0 新增可控重定向功能

v2.4.0 新增 NavigationRedirect 接口，守卫可返回 { location, mode } 显式指定重定向方式，mode 优先于原始导航方式；若原始为 back 且未指定，则回退 relaunch。同时修复 ChannelPlugin 注入内部 key 导致 URL 出现双 ? 的问题。完全向后兼容，现有守卫写法不受影响，适用于登录页 replace 等场景。

2026-08-21 21:29:37 444

原创 RouterLink H5端控制台错误修复

摘要： @meng-xi/uni-router v2.3.1 主要修复了 RouterLink 组件在 H5 端因使用 <navigator> 未设置 url 属性导致的控制台错误，通过改用 <view> 组件并保留点击态功能解决。同时优化了组件 emits 类型定义，将 interface 统一改为 type 风格以保持代码一致性。该版本为补丁更新，无破坏性变更，完全向后兼容，用户升级无需修改现有代码。

2026-08-20 20:59:10 226

原创 uni-router v2.3.0 新增 useLink 和导航失败检查

v2.3.0 新增 useLink 组合式 API，暴露 RouterLink 内部行为，支持自定义导航组件和获取路由匹配状态；新增 isNavigationFailure 工具函数，简化导航失败的类型检查与错误处理。同时重构 composables 目录，提升代码可维护性。这些改进使自定义导航逻辑和精细化错误处理更加灵活高效。

2026-08-19 19:15:12 372

原创 Vue Router 4.x风格导航守卫全面升级

uni-router v2.2.0 版本带来两项重要更新：1）彻底移除 next() 回调模式，统一采用返回值模式；2）新增 onBeforeRouteLeave 组件内离开守卫。本次升级使守卫系统与 Vue Router 4.x 完全一致，解决了表单编辑等场景下无法优雅拦截页面离开的问题。组件内守卫支持同步/异步操作，自动随组件卸载清理，无需手动管理全局守卫。迁移时需将所有 next() 调用改为对应的返回值形式，路由拦截逻辑现可更自然地封装在组件内部。

2026-08-18 12:45:55 184

原创 uni-router v2.1.0 升级：导航守卫全面支持返回值模式

v2.1.0 将导航守卫升级为返回值模式（return undefined/false/RouteLocationRaw），无需 next() 回调，简化异步逻辑并避免回调嵌套与遗漏。重定向支持指定 replace/relaunch 模式；afterEach 新增 failure 参数捕获失败信息。旧版回调模式仍兼容但标记为弃用。同步修复了 next() 未调用导致导航挂起、守卫中止后 afterEach 缺失失败信息的问题。新旧模式自动识别，混用会警告，可平滑过渡。

2026-08-17 00:47:03 305

原创 uni-app路由插件化：解锁高效开发新姿势

v2.0 通过插件化设计将核心功能拆分为 ParamsPlugin（参数传递）、ChannelPlugin（页面通信）、InterceptorPlugin（路由守卫）和 AnimationPlugin（导航动画）四个独立插件，支持按需加载，未注册插件不增加包体积。新版保留 vue-router 风格 API、完整守卫体系和组合式 API 等特性，提供 7 种生命周期钩子实现深度扩展。在 uni-app 静态路由基础上构建现代化可扩展路由层，兼容原生 pages.json，满足复杂应用需求。

2026-08-11 23:35:29 374

原创 Vite插件v1.1.0发布：自动导入全面重构

v1.1.0版本对自动导入插件进行了全面重构，主要更新包括：1）内置预设系统简化配置，支持vue、vue-router等常用库一键导入；2）新增多种导入形式（别名、类型、命名空间等）；3）自动生成ESLint/Biome配置解决未定义变量问题；4）优化性能，新增缓存机制和HMR热更新；5）移除旧版兼容类型，需按迁移指南调整配置。升级时需修改版本号为^1.1.0，少量Breaking Changes仅影响直接使用废弃类型的用户。

2026-07-28 21:27:43 461

原创 uni-router v2.0.0：四大功能拆分为插件，按需加载

v2.0.0 引入插件化架构，将参数传递、页面通信、导航动画、API 拦截拆分为独立插件，未注册不增加开销；修复 usePageChannel() 返回空通道和 onShow 重复同步状态 Bug；通过生命周期 Hook 实现按需加载，未注册功能抛出 PLUGIN_REQUIRED 错误。

2026-07-13 00:44:18 370

原创 v1.11.0 发布：全新 TabBar 组件体系与 SCSS 主题定制全面升级

v1.11.0 为 uni-router 新增 TabBar / TabBarItem 自定义底部导航栏组件，支持徽标（badge / dot）、切换拦截器（beforeChange）及插槽自定义，突破原生 tabBar 无法动态控制、不支持徽标和拦截等限制。同时，组件样式全面迁移至 SCSS，支持 CSS 自定义属性运行时覆盖与 SCSS 变量编译时覆盖双层级主题定制；组件目录按 easycom 规范重构，npm 用户可配置自动注册。本次更新向后兼容，升级无忧，并为开发者提供更灵活、可扩展的导航解决方案。

2026-07-10 20:09:54 405

原创 uni-router新推useUniEventChannel，彻底解决页面通信难题

v1.10.0 新增 useUniEventChannel 与 UniEventChannel 类，基于 uni.$emit/$on 实现页面间通信，支持所有导航方式双向通信、Sticky 缓存解决时序竞态、H5 刷新重建通道，提供统一组合式 API usePageChannel()；通过 navigationId 隔离事件，__nav_id 保持刷新后通道重建。

2026-07-09 20:02:50 473

原创 V1.9.0重磅更新：自动路由同步与架构优化

v1.9.0 优化 uni-router：新增全局 mixin 自动同步路由状态，修复 back() 参数丢失与 setCurrentRoute 时机问题，重构核心模块（拆分 router/index.ts 与 interceptor/index.ts，统一错误类）。降低心智负担，增强稳定性。

2026-07-07 01:40:23 537

原创 Vite插件v0.2.6：架构优化与自动化升级

v0.2.6 内部重构：提取工具函数至 common 模块（6 个子模块），版本号构建时自动注入，目录名统一，无破坏性变更，可平滑升级。

2026-06-26 13:19:31 472

原创 uni-router v1.7.0重磅更新：守卫重定向自由掌控

v1.7.0版本为路由守卫的next()回调新增了可选options参数，支持在重定向时显式指定导航方式（push/replace/relaunch），突破了原有导航方式的绑定限制。更新后：1）可通过next(location, {mode:'replace'})强制指定重定向方式；2）未指定时保持向后兼容，沿用原始导航方式；3）新增类型导出支持开发。典型应用场景包括登录拦截统一使用replace跳转、退出登录重置页面栈等，解决了历史页面残留问题，同时保持了对旧代码的完全兼容。

2026-06-26 01:06:03 459

原创 Vite插件v0.2.5：注释头模板化升级

v0.2.5版本更新摘要：本次升级将generateRouter的fileHeader参数进化为支持占位符的headerTemplate模板系统，允许自定义注释头内容、顺序和日期格式。新增{name}、{date}、{version}等占位符，支持通过customFields注入自定义字段。移除了废弃的serializeValueCompact函数。升级需将配置中的fileHeader替换为headerTemplate，并注意模板语法和自定义字段的使用方式。

2026-06-25 13:01:43 230

原创 V1.6.2修复isReady()过早触发问题

v1.6.2 修复了 `isReady()` 在 `createRouter()` 构造时即触发的问题，将其推迟到 `app.use(router)` 安装阶段，确保回调中可安全使用所有已安装插件

2026-06-25 00:02:42 239

原创 UniApp路由配置升级：pages.json权威指南

v0.2.4版本更新聚焦于将pages.json作为路由配置的唯一权威来源，主要带来两项优化：1）新增页面级name属性支持，允许在pages.json中直接配置路由名称（优先级高于自动生成的nameStrategy）；2）优化preserveRouteChanges合并策略，确保来自pages.json的name和meta字段始终使用最新值，同时保留用户自定义的额外字段。

2026-06-24 12:30:18 239

原创 V1.6.1性能优化：高频路径提速与代码精简

v1.6.1版本针对路由状态管理进行了两项内部优化：1）在isSameQuery方法中增加了引用相等和双空对象的快速路径，减少了高频调用场景下的计算开销；2）将分散在setCurrentRoute和createStartLocation中的Object.freeze逻辑集中到createRouteLocation工厂函数，提升了代码可维护性和一致性。这些优化不改变外部API行为，用户可直接升级获得性能提升而无需修改现有代码。

2026-06-24 00:11:05 353

原创 Vite插件0.2.3重磅更新：路由生成更智能

v0.2.3版本更新摘要（149字）：本次更新重点优化插件开发体验和路由生成能力。主要改进包括：1）将BasePlugin的addPluginHooks改为非抽象方法，简化简单插件开发；2）重构钩子注册机制，统一使用onConfigResolved/destroy生命周期方法；3）支持在pages.json中直接配置页面级meta字段，优先级高于metaMapping；4）新增原始文本保留算法，确保重新生成路由时保留用户自定义属性（如beforeEnter）。

2026-06-23 12:23:38 173

原创 uni-router v1.6.0重磅更新：安全传参新姿势

uni-router v1.6.0 更新摘要本次更新重点增强了页面参数传递功能：1.新增 params 机制；2.引入参数持久化存储；3.提供查询参数增强方法；4.修复导航解析阶段的params丢失问题，并扩展RouterLink组件支持params传递这些改进使uni-app页面间数据传递更安全、高效，尤其适合复杂数据和敏感信息的场景。

2026-06-23 00:38:09 527

原创 V0.2.2发布：修复多行格式输出问题

v0.2.2版本修复了v0.2.1中路由对象多行格式输出的两个问题：属性间缺少逗号分隔符和非首行缩进多一层。前者会导致语法错误，后者造成格式不统一。修复后路由配置自动生成更规范，完全向后兼容。该版本属于uni-router插件系列，包含15个实用插件，覆盖构建优化的各个方面，如资源清单、自动导入、体积分析等。升级只需修改devDependencies中的版本号为^0.2.2即可。

2026-06-21 22:51:00 374

原创 uni-router 0.2.1发布：路由配置更可读更可靠

v0.2.1版本更新主要优化了uni-app路由生成插件的可读性和可靠性。新增文件注释头功能，支持多行格式输出，修复了meta字段合并和函数属性解析问题。关键改进包括：1) 自动添加版本/时间信息的文件注释头；2) 路由对象改为多行格式提升可读性；3) 修复自定义meta字段丢失问题；4) 解决含函数属性的路由合并失败问题。升级需修改依赖版本至^0.2.1，配置fileHeader即可启用新特性，完全向后兼容。

2026-06-21 21:53:26 434

原创 uni-router：现代化路由管理方案

本文介绍了 uni-router v1.5.0 的设计理念与核心功能。针对 uni-app 原生路由系统的不足（如缺少路由守卫、命名路由等功能），uni-router 提供了 vue-router 风格的路由管理方案，同时保持与 pages.json 的兼容性。

2026-06-19 07:14:12 417

原创 Vite插件v0.2.0：开发代理新升级

v0.2.0版本聚焦于优化Vite开发代理体验，推出proxyManager插件，通过声明式规则体系实现环境切换、延迟模拟、请求日志等开发期需求。该版本将代理配置从vite.config.ts解耦，支持独立规则文件和环境变量动态覆盖，同时提供响应修改和三级日志输出功能。新增工具模块common/format和common/fs增强代码复用性，修复了proxyManager的四个关键缺陷。升级方式为修改devDependencies版本号至^0.2.0，完全向后兼容。

2026-06-19 00:07:04 207

原创 uni-router：现代化uni-app路由解决方案

本文介绍了 uni-router v1.4.0 的设计理念和核心功能，旨在为 uni-app 提供类似 vue-router 的路由管理方案。uni-router 弥补了 uni-app 原生路由系统在守卫、命名路由、元信息、错误处理等方面的不足，同时保持与 pages.json 的兼容性。

2026-06-16 23:32:29 259

原创 Vite插件开发框架：14个实用插件与完整工具包

摘要： @meng-xi/vite-plugin 是一个多功能 Vite 插件工具包，提供 14 个开箱即用插件（如资源压缩、版本生成、环境校验等）和一套插件开发框架。核心特性包括：插件开发框架、模块化支持、日志系、通用工具库。

2026-06-14 20:59:01 607

原创 Vite 0.1.8：图片优化神器，构建更轻量

v0.1.8版本新增了imageOptimizer插件，可在Vite构建后自动优化图片资源，支持7种格式的压缩和WebP/AVIF格式转换，通过并发处理提高效率并生成压缩报告。同时增强了Common工具模块，包括并发控制、路径处理等功能。该版本无破坏性变更，可通过更新依赖版本号平滑升级，帮助开发者显著减小图片体积，完善前端工具链。

2026-06-12 20:48:04 330

原创 uni-router：uni-app路由管理新选择

@meng-xi/uni-router 是为 uni-app 设计的现代化路由管理方案，基于 v1.3.0 版本提供完整功能。它在 uni-app 原生静态路由基础上，扩展了路由守卫、命名路由、元信息、错误处理等关键能力，采用不替代 pages.json 的设计理念，完全兼容原生 API。

2026-06-12 12:42:49 417

原创全面解析uni-router v1.2.0功能

@meng-xi/uni-router 是为 uni-app 设计的增强路由方案，在原生 pages.json 基础上提供 vue-router 风格的现代化路由管理能力。核心功能包括：1）支持命名路由和元信息配置；2）完整路由守卫体系（全局/路由独享）；3）导航动画支持（App端）；4）智能路由跳转（自动区分普通页/Tab页）。该方案兼容 uni-app 原生机制，不替代 pages.json，通过封装原生 API 实现跨平台一致性，解决了原生路由缺少权限控制、状态同步等问题

2026-06-11 21:35:11 305

原创 uni-app实现vue-router开发体验

文章摘要：《@meng-xi/uni-router：为uni-app打造的类vue-router解决方案》针对uni-app声明式路由在大型项目中的痛点，提供了完整的路由管理方案。该库在不改变uni-app页面模型的前提下，实现了导航守卫、命名路由、类型提示等高级功能

2026-06-11 12:06:21 441

原创 uni-router v1.1.2 重磅升级：守卫超时+路由监听

优化getCurrentPages()等API的环境兼容处理。提升全平台运行稳定性。

2026-06-10 12:58:42 454

原创 uni-router v1.1.1发布：守卫超时保护+路由监听

uni-router v1.1版本主要优化了导航可靠性和路由状态同步能力。v1.1.0新增守卫超时保护机制，通过guardTimeout配置防止异步守卫永久挂起；引入onRouteChange统一监听导航和同步变化，并添加_synced标记区分来源；RouterLink组件新增错误事件处理。v1.1.1修复了back()未触发afterEach、守卫模式错误、query变化忽略等关键问题，同时解决了app.onUnmount的兼容性问题。

2026-06-10 01:19:06 326

空空如也

空空如也