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

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

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

• 作者在相关 issue 的回复： https://github.com/vuejs/router/issues/2569#issuecomment-3405172967
• 作者的废弃警告： https://github.com/vuejs/router/commit/9b22edcff3acd9782dd86257b2744c1ae35a455e

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

在特定的 vue-router@4.6.0 版本内，就会出现构建故障。

• 流水线失败的案例： 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 项目在 vue-router@4.6.0 版本下是失败的

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

如下图所示，在依赖关系指定为 vue-router@4.6.0 时，是失败的。

uniapp H5 项目在 vue-router@4.5.1 版本下是成功的

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

如下图所示，在依赖关系指定为 vue-router@4.5.1 时，是成功的。

uniapp H5 项目在 vue-router@4.6.3 版本下是成功的

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

如下图所示，在依赖关系指定为 vue-router@4.6.3 时，是成功的。

有什么故障先例？

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

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

• 成熟先例： https://github.com/dcloudio/uni-app/commit/3b71fdda2206339629de1985be629804f3535d77

预期被修改的文件

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

贡献者

ruan-cat

页面历史

最后编辑于 大约 1 个月前

查看完整历史

2f70c10-📃 docs(notes): 记录关联任务文章。

cc4f35e-🐳 chore(notes): 标记pr任务进度，太麻烦，不跟进了。有空再说。

1f4fce8-📃 docs(notes): 设计【安装来自本地的依赖包】的提示词任务。

bfb2d7f-🐳 chore(notes): 记录杂项文本。

ec66c13-📃 docs(notes): uniapp H5 项目在 vue-router@4.6.3 版本下是成功的

5c80510-📃 docs(notes): uniapp H5 项目在 vue-router@4.5.1 版本下是成功的

30799f7-📃 docs(notes): 已经发布pr。

b3f7f83-📃 docs(notes): 逐步设计【更改 vue-router 的导入写法，以便适应 vue-router 在未来 v5 版本内，更改文件导出格式所带来的破坏性变更】

f6b12e4-📃 docs(notes): 设计好关于 vue-router v5 版本的破坏性变更 pr。