更改 vue-router 的导入写法，以便适应 vue-router 在未来 v5 版本内，更改文件导出格式所带来的破坏性变更

[ruan-cat]

问题背景：为什么要更改？

vue-router 明确在未来的 v5 版本内不会提供 dist/vue-router.esm-bundler.js 导出文件

• 作者在相关 issue 的回复： vue-router.esm-bundler.js not exported in [email protected] version vuejs/router#2569 (comment)
• 作者的废弃警告： vuejs/router@9b22edc

为什么选择在 vue-router v5 版本还没有发版的时候就提前适配？

在特定的 [email protected] 版本内，就会出现构建故障。

• 流水线失败的案例： https://github.com/nwt-q/001-Smart-Community/actions/runs/18517921823/job/52772087484
• 最小复现案例： https://stackblitz.com/~/github.com/ruan-cat/bug-in-vue-router-4.6.0-with-uniapp?file=package.json

不更改会带来什么问题？

uniapp H5 项目在 [email protected] 版本下是失败的

• 可复现案例，切换到 4.6.0 分支： https://github.com/ruan-cat/bug-in-vue-router-4.6.0-with-uniapp/tree/4.6.0

如下图所示，在依赖关系指定为 [email protected] 时，是失败的。

uniapp H5 项目在 [email protected] 版本下是成功的

• 可复现案例，切换到 4.5.1 分支： https://stackblitz.com/~/github.com/ruan-cat/bug-in-vue-router-4.6.0-with-uniapp?file=package.json

如下图所示，在依赖关系指定为 [email protected] 时，是成功的。

uniapp H5 项目在 [email protected] 版本下是成功的

• 可复现案例，切换到 4.6.3 分支： https://github.com/ruan-cat/bug-in-vue-router-4.6.0-with-uniapp/tree/4.6.3

如下图所示，在依赖关系指定为 [email protected] 时，是成功的。

有什么故障先例？

• fix(vite-plugin-uni): 修复 pinia v3 版本 访问 dist 报错的bug

模仿 pinia v3 版本的更改先例，提前更改 vue-router v5 版本的导入写法

• 成熟先例： 3b71fdd

预期被修改的文件

• https://github.com/dcloudio/uni-app/blame/next/packages/vite-plugin-uni/src/configResolved/plugins/resolveId.ts

[ruan-cat]

@chouchouji 你好，请审阅pr。

[chouchouji]

应该是引入 vue-router.mjs，这个文件是一直存在的，vue-router.esm-bundler.js 的内容也是引入 vue-router.mjs

我不是很确定 vuejs/router#2572 说的内容是否对uniapp有潜在的影响，需要进行测试web和app端表现是否正常

[ruan-cat]

@chouchouji 你说的对。已作出更改，现在改成导入 dist/vue-router.mjs 的写法，均满足 v4 和 v5 版本的要求。

[chouchouji]

@chouchouji 你说的对。已作出更改，现在改成导入 dist/vue-router.mjs 的写法，均满足 v4 和 v5 版本的要求。

不要版本判断，修改为 dist/vue-router.mjs 应该也没问题吧

[chouchouji]

还需要做一下验证，uniapp和uniappx的web端和uniapp的app端项目能不能正常运行

[ruan-cat]

@chouchouji 你说的对。已作出更改，现在改成导入 dist/vue-router.mjs 的写法，均满足 v4 和 v5 版本的要求。

不要版本判断，修改为 dist/vue-router.mjs 应该也没问题吧

1. 可以的，没有问题。未来 vue-router 会用 tsdown 构建 tsdown 的构建产物是包含有期望的 dist/vue-router.mjs 文件。

2. 在现在的 [email protected] 内，存在 dist/vue-router.mjs 文件。

至少可以肯定，dist/vue-router.mjs 文件在 v4 和 v5 版本都是存在的。有足够的健壮性。

稍后我新建一个全新的 uniapp vite-ts 项目，测试 web 端和 app 端场景下是否正常可用。

[ruan-cat]

@chouchouji 自测结果如下，web端和app端均通过测试。

1. 针对如下结构的测试项目，被测依赖 @dcloudio/vite-plugin-uni 以工作区的形式，直接链接到本地 uniapp monorepo 的一系列本地构建包。

2. web端 H5，能够正常显示，且没有明显报错。

3. 在本地使用 夜神模拟器 以app形式启动：

4. 在模拟器内，app端能够正常运行。

[chouchouji]

最好是测试一些大型项目，vue router主要是路由相关的，比如 hello-uniapp 和 hello-uniapp-x 这两个大型项目。还有要看看 uni-app-x 上是否正常

[Copilot]

Pull Request Overview

This PR updates the vue-router import path to prepare for breaking changes in the upcoming v5 release, where the dist/vue-router.esm-bundler.js file will be removed. The change from dist/vue-router.esm-bundler.js to dist/vue-router.mjs ensures compatibility with both current versions (4.6.3+) and future v5 releases, while also fixing build failures that occur specifically in vue-router v4.6.0.

• Updated vue-router module resolution path to use the new .mjs export format
• Follows the established pattern from the pinia v3 migration
• Prevents build failures in uniapp H5 projects when using affected vue-router versions

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}