梦曦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 579

原创 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 793

原创 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 729

原创 v0.2.0 架构升级：class + reactive 重塑状态管理

v0.2.0 为重大架构升级，采用 class + reactive 形式重构 store，解决 UTS 平台无 Proxy 与反射的限制，实现完整 Pinia 实例 API（$patch/$reset/$subscribe 等）及内置持久化插件。移除旧版 setup 式 API，通过 defineStore 定义类形式 store，支持强类型 state、getter 派生值与 method action，自动落盘与恢复。兼容 Web、Android，iOS/鸿蒙待实测，迁移需替换定义方式与调用语法。

2026-11-01 00:21:40 143

原创 H5返回失效？0.8.1修复关键问题

v0.8.1 为修复 H5 刷新或冷启动进入非首页后返回无效问题的 PATCH 版本。核心修复：当页面栈深度不足时，back() 及根路径 reLaunch 将兜底至入口页（首个 isTab 路由），避免静默丢弃。兼容性不变，仅行为优化，无破坏性变更。

2026-10-29 17:49:38 94

原创 uni-app x 新组件库v0.1.0发布，多端统一开发

一套源码编译至 App（Android/iOS/HarmonyOS）、Web、小程序。支持 easycom 零注册；视觉参数统一为 $m-* SCSS 变量，编译期注入实现零运行时主题定制。内置 11 个基础组件（按钮、单元格、栅格、图标等），跨端一致处理 0.5px 边框、按压反馈、加载动画等细节。Web 已全量验证，多端代码已适配，蒸汽模式编译通过。

2026-10-27 12:58:50 327

原创 uni-app x工程化实战：从页面堆到可维护架构

本文基于uni-app x的工程化约束，提出一套可验证的中大型项目架构方案：通过唯一装配点main.uts实现依赖注入，采用模块级内存缓存解决异步存储问题，设计三层鉴权守卫机制保障安全，严格遵循“类型随消费”原则，杜绝泛型擦除与工具类型滥用，并统一反馈层。全链路经Web端验证，模板开源（MIT），适配多端编译特性，突破“页面堆”困境，实现可维护、高性能的跨端工程体系。

2026-10-21 19:36:08 279

原创 Taro vs uni-app：技术路线与选型真相

Taro 走 React 运行时 + Web 范式，生态复用强、控制力高，适合 React 团队与复杂项目；uni-app 走 Vue 编译 + 全链路封装，开箱即用、多端覆盖，适合 Vue 团队与快速迭代。选型取决于技术栈复用与对控制力/交付速度的权衡。

2026-10-20 19:35:18 196

原创 unix-utils v0.2.0 发布：modal 全端统一，自绘窗口解决输入框难题

unix-utils v0.2.0 正式发布，新增 modal 模块，全端兼容封装 uni.showModal，覆盖 Android/iOS/Web/微信/鸿蒙。App 端改用自绘窗口实现，彻底解决输入框光标、透明色失效、按钮截断等长期问题；微信/鸿蒙保留原生通道并结构化降级留痕。参数同构、返回值恒互斥，支持 Promise 式调用、alert 语义及全局配置。破坏性变更：showToastAsync reject 值改为 JSON 字符串，确保全端一致。

2026-10-19 21:40:36 178

原创 uni-app x 专属 Pinia 库正式发布

unix-pinia 首个版本，专为 uni-app x vdom 模式设计，基于原生响应式原语（ref/computed/watch），解决 UTS 平台无法编译标准 Pinia 的问题。通过模块级注册表实现跨页面单例，提供 defineStore、storeToRefs 等一致 API，实例方法以顶层函数形式映射。Web 与 Android 真机全用例通过、云打包零错误。核心理念：一比一复刻可移植部分，裁掉项均有明确原因与替代方案，未来迁移标准 Pinia 几乎零成本。

2026-10-18 20:11:35 114

原创 uni-storage 0.1.0 发布：TTL过期管理+多实例隔离

unix-storage v0.1.0 是首个基于 uni.setStorage 的轻量级持久化库，解决回调嵌套、无过期管理、key 冲突与多实例隔离等痛点。支持 Promise 化 API、TTL 过期自动清理、命名空间隔离与多实例独立配置，兼容 Web、Android 及微信小程序，错误统一结构化。开箱即用，对标 axios 风格，提升开发效率与数据安全性。

2026-10-17 11:14:20 291

原创 uni-request 重磅发布：三端统一网络请求新标准

unix-request v0.1.0 是首个基于 uni.request 的跨端网络库，以 axios 风格封装请求，统一处理 URL 拼接、参数编码、错误收敛与取消逻辑。支持 Web、微信小程序、Android 三端编译验证，提供泛型类型安全、拦截器、可预测错误结构及确定性取消机制。全链路强类型标注，多端行为一致，降低重复开发成本，提升开发效率与可维护性。

2026-10-13 22:37:37 144

原创 uni-app、uni-app x 与 Flutter 深度对比：2026年跨平台开发框架选型指南

2026 年跨平台框架竞争激烈。uni-app 生态成熟，覆盖小程序与多端，适合预算有限、Vue 为主的项目；uni-app x 凭语言翻译架构实现原生级性能与鸿蒙原生支持，蒸汽模式渲染超原生 2-3 倍，可无缝调用原生 API；Flutter 桌面端与全球生态领先，但不支持小程序、国内适配弱且学习成本高。综合：兼顾性能、鸿蒙与多端覆盖选 uni-app x；侧重快速落地与小程序生态选 uni-app。

2026-10-12 18:47:20 503

原创 uni-app x 强力工具库 unix-utils 正式发布

unix-utils首个版本发布，为uni-app x提供全端兼容的toast工具，基于UTS源码通过uni_modules与npm双轨分发。其完全兼容uni.showToast API，自动处理各端差异：Android/iOS支持position/精确duration，Web自绘渲染，小程序/鸿蒙降级留痕。支持icon超集、三值position、Promise式调用及全局配置，失败信息结构化可追踪。零配置自动分发，无第三方依赖，助力跨端统一提示体验。

2026-10-09 22:44:50 208

原创 0.8.0重磅发布：路由自动生成功能上线

v0.8.0 为非破坏性升级，核心新增基于文件的路由生成插件，支持页面就近声明，构建期自动同步生成 pages.json 与路由表，消除双份维护；修复 Android 云打包 UTS 编译错误、H5 端 router.push 崩溃及 uni.* 编译警告，并补全 App 端导航动画透传。三独立插件可按需组合使用，兼容旧代码，升级无需修改。

2026-09-27 20:17:14 231

原创 Windows兼容修复：依赖自动安装与H5入口问题解决

v1.2.1 修复 Windows 平台依赖自动安装失败（spawnSync pnpm ENOENT）及 H5 启动时 Failed to load url /main.ts 问题，通过 shell 启动命令与修正入口路径 /src/main.ts 恢复正常。建议 Windows 用户升级至最新版，旧项目仅需修改 index.html 入口路径即可。支持快速创建 UniApp 项目，兼容 H5、小程序等多端开发。

2026-09-21 12:38:55 146

原创 uni-app x 0.7.0重磅升级：插件实例化，原生编译彻底打通

uni-app x v0.7.0 为破坏性更新，核心是实现 App 原生（Kotlin/Swift）非蒸汽编译。重构旧有工厂模式与对象字面量写法，全面改为 class 化结构，满足 UTS 原生规范，解决数百处编译错误。插件注册需改为实例化（如 new ParamsPlugin()），内置插件均升级为 abstract class。修复导航、模板绑定、ucss 等原生兼容问题，提升跨平台一致性。升级需调整插件注册方式，其余 API 不变。支持非蒸汽模式编译，迈向真正原生运行。

2026-09-20 19:30:02 217

原创 uni-app x 事件通信插件重磅上线

v0.6.0 为 MINOR 版本，新增 EventsPlugin 插件，补齐 uni-app x 缺失的页面间定向通信能力。通过 events 监听表与 useOpenerEventChannel 实现打开方与被打开页间的回传与推送，支持 onShow 内即时通信。采用双层通道读取机制保障时序可靠性，无破坏性变更，升级无需修改代码，注册插件后即可使用。

2026-09-18 12:29:10 173

原创修复安卓打包报错，0.5.1 版本更新

v0.5.1 为修复版，解决安卓基座打包时因 UTS 不支持函数返回类型中直接声明对象字面量导致的编译错误（UTS110111101）。通过将 currentStack() 返回类型从内联对象字面量改为具名接口 CurrentStackInfo，兼容 Kotlin 编译要求。本版本仅 core 层更新，无 API 变更，升级无需修改代码。

2026-09-17 12:39:15 173

原创修复 .uvue 页面路径残留问题

v1.4.1 为 uni-app x 项目修复 .uvue 页面支持问题：动态剥离 includeExtensions 中的扩展名，确保 pages.json 路径不含后缀；同时修正 defineUniPage 宏未被移除的问题，兼容 .uvue / .nvue SFC 模块识别。无新功能，无破坏性变更，升级至 ^1.4.1 后重新生成即可生效。

2026-09-16 19:25:15 160

原创 0.5.0重磅发布：动画插件+H5体验全面优化

v0.5.0 版本新增跨端导航动画插件 AnimationPlugin，支持 App/小程序原生动画与 H5 Web Animations API，实现滑入、淡入等 9 种动画类型，并修复 H5 首次进入卡顿及返回动画不生效问题。查询参数工具 queryInt 等现可直接从库入口导出，升级无破坏性变更，兼容旧版本。

2026-09-16 00:07:20 241

原创 v0.4.0重磅升级：params统一机制+RouterLink公开

v0.4.0 为次要版本，核心变更包括：统一 params 传递机制，移除旧式 __unixr_p_ 明文编码，改用 ParamsPlugin 通过 __params__ key 安全传递，支持跨刷新持久化；新增公开导出的 RouterLink 组件，兼容声明式导航并修复样式合规问题；全库完成 UTS 合规，消除 undefined 残留与 Web 编译警告。升级需注册 ParamsPlugin，旧链接将不再恢复参数。

2026-09-13 09:01:36 56

原创 unix-router v0.3.0 发布：params 持久化+插件体系升级

v0.3.0 完善插件体系（七大导航 hook + PluginContext），新增 paramsPersistent 持久化参数（跨刷新保留），补齐 guardRoute/onRouteChange，修复内部 key 泄漏与空值崩溃。

2026-09-11 01:02:38 144

原创 uni-router v0.2.0重磅发布：全链路拦截+重复导航优化

v0.2.0 新增 interceptUniApi 配置（默认关闭），启用后直接调用 uni.navigateTo/redirectTo/switchTab/reLaunch/navigateBack 的跳转也会被拦截并转入守卫链，实现全量导航守卫覆盖（H5 switchTab 特判放行，同步路由状态）。优化重复导航判定：从「path+query」扩展为「path+query+params+hash」全部一致才判 DUPLICATED，允许以新参数重入当前页刷新数据。需对应平台运行时版本。

2026-09-09 23:44:35 104

原创 @meng-xi/uni-router 未来展望：夯实基础、深化体验、探索前沿

项目已实现 Vue Router 4.x 全面对齐、插件化架构（v2.0.0）、跨端 H5 能力增强（v2.6.0/v2.7.0）及生态工具配套。未来方向：短期修复 H5 返回拦截等边缘问题，打磨 guardRoute 冷启动守卫；中期丰富插件生态（数据预取/页面缓存）、优化性能、探索与 uni-app x（UTS）融合；长期推进文件系统路由、微前端等前沿能力。同时完善文档与社区建设，降低上手门槛。

2026-09-08 23:06:08 130

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

unix-router v0.1.0：uni-app x 路由库，UTS 源码跨端编译（Web/小程序/Android/iOS），对标 vue-router 4，支持守卫、组合式 API、参数传递、错误体系与状态自动同步，随 uni_modules 分发。

2026-09-06 23:36:45 384

原创 @meng-xi/create-uni-app vs unibest：轻量脚手架与重型框架的定位之争

create-uni-app：轻量交互式脚手架，按需生成零冗余骨架，技术栈自由选择。unibest：重型开发框架，开箱即用，默认 TS + UnoCss + wot-ui + Pinia，内置完整工程化方案。前者“搭架子”，后者“精装房”，服务于不同开发者需求。

2026-09-04 21:38:40 219

原创 create-uni-app v1.2.0：交互体验优化

v1.2.0 聚焦交互体验优化：内置主题改为可选功能（并入可选功能多选，勾选后挑色板）；目标平台分组互斥（勾选「全部端/小程序全部/快应用全部」时覆盖的具体平台自动禁用）；uni-ui 按预处理器联动（未选 Sass/Scss 时自动禁用并提示）。修复非 scss 方案不再生成无用 uni.scss。

2026-09-03 23:39:02 240

原创 create-uni-app v1.1.0：结构化生成，工程骨架更规范

v1.1.0 聚焦生成结构的规范性与可维护性：状态管理统一归入 stores/ 目录（Pinia/Vuex 均结构化封装）；路由实例与守卫分离为 router/index + router/guards；主入口仅保留引用，不再内联逻辑。TS 项目生成 vite.config.ts，JS 仍为 .js；package.json 依赖按字母序标准化；安装失败时输出更友好的错误提示。

2026-09-02 22:34:55 391

原创 @meng-xi/create-uni-app v1.0.0 正式发布

基于 uni-app + Vue3 + Vite 的交互式脚手架，通过命令行问答按需生成项目骨架。支持 TS/JS 互斥、多平台勾选、四种内置主题、Pinia/Vuex 状态管理、uni-router 路由方案、请求封装与登录鉴权等可选集成，配套 create/info/config 命令。不勾选的能力一律不出现，杜绝多余依赖。支持 npm i -g 全局安装或 npx 免安装使用。

2026-09-01 20:33:58 196

原创 v2.7.1：修复 H5 端返回死循环闪烁问题

v2.7.1 为关键修复版本，解决 H5 端返回时页面在相邻页面间反复切换闪烁、无法正常返回的问题（issue #39）。根因是 onBeforeBack 的 H5 popstate 守卫在「撤销后退 + 重放」过程中自触发死循环。修复方案通过返回进行中标记（h5ReturningBack）+ 目标 URL 命中判定双重机制断开自触发链路，无论 router.back() 还是浏览器原生后退均恢复正常。完全向后兼容，PATCH 版本无 API 变更。

2026-08-31 21:05:17 246

原创 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 438

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

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

2026-08-28 16:23:08 311

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

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

2026-08-27 15:00:04 384

原创 @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 214

原创 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 213

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

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

2026-08-23 23:11:03 216

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

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

2026-08-21 21:29:37 451

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

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

2026-08-20 20:59:10 236

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

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

2026-08-19 19:15:12 380

空空如也

空空如也