Vue4 已在规划中:无重大破坏性变更,全面转向 ESM,Vue 2 项目该紧张吗?
Vue 4 确实在规划了,但先别急着升级。
2026 年 10 月,尤雨溪在东京举办的 Vue Fes Japan 大会上确认,Vue 4 已经进入规划阶段。消息传开后,很多人的第一反应是:要不要现在就开始准备迁移?答案比想象中简单——Vue 4 目前没有发布时间表,核心方向只有一个:不让你重写代码。
最重要的一句话:不会有大规模破坏性变更
尤雨溪在现场特意强调了这一点:Vue 4 不会带来大的 breaking changes。
经历过 Vue 2 升 Vue 3 的开发者,对这句话的分量应该很清楚。当年不少项目卡在依赖不兼容、第三方库没有跟上、构建配置需要重写这些事情上,迁移周期拖了几个月甚至更久。到现在,还有相当一部分存量项目留在 Vue 2。
所以 Vue 4 选择了一条不同的路:API 保持稳定,把变化放在底层和工具链上。对于正在维护 Vue 3 项目的团队来说,这大概率意味着升级成本远低于 2 到 3 的那一次。
唯一明确的技术变化:只提供 ESM 构建
目前 Vue 4 最确定的一项调整,是放弃 CommonJS 构建产物,只发布 ESM 版本。
这件事本身不复杂,但影响面值得提前看清楚。ESM 是 JavaScript 的现代模块标准,Vite、现代 Node.js、TypeScript 都已经围绕 ESM 构建。继续同时维护 CJS 和 ESM 两套格式,对框架团队来说是持续的维护负担,对使用者来说也增加了模块解析出错的概率。
Vue 生态已经在往这个方向走了。Pinia v4 已经明确转向 ESM Only,Vue Router 6 也计划跟进。Vue 4 只是把这件事推到框架层面。
哪些项目需要提前留意?
新项目基本不用紧张。 如果你现在用的是 Vue 3 + Vite + TypeScript,代码里写的是 import,构建工具也是 Vite,那么 Vue 4 的 ESM 策略对你几乎没有额外动作。
需要提前检查的是老项目,尤其是下面几种情况:
还在用 Webpack 4 或更老的构建工具。这些工具对 ESM 的支持不完整,迁移时需要连同构建链一起考虑。
代码里大量使用 require()。ESM 环境下 require 不能直接使用,业务代码、测试脚本、构建配置都要逐步换成 import。
Node.js 版本较老。ESM 在旧版本 Node 中的支持有限,升级 Vue 4 之前需要先把运行时版本提上来。
依赖中有只支持 CommonJS 的包。这是比较隐蔽的卡点,需要检查 node_modules 里关键依赖的模块格式。
一个实用的自查方法是:在 package.json 里加上 "type": "module",跑一遍构建和测试,看看哪里报错。报错的位置就是后面需要处理的地方。不用现在就改,但可以把它记进技术债清单。
Vapor Mode 不是 Vue 4 的专属功能
原文里提到 Vapor Mode 是否属于 Vue 4 还不确定,这个说法需要纠正。
Vapor Mode 实际上是 Vue 3.6 的功能,并且已经在 3.6 的 release candidate 阶段完成了特性开发。它的目标是通过新的编译方式减少对虚拟 DOM 的依赖,降低运行时开销。也就是说,Vapor Mode 不会等到 Vue 4 才出现,Vue 3.6 就会带上它。Vue 4 和 Vapor Mode 是两条线,不需要混在一起理解。
Vue 2 和 Vue 3 的现状,用数据说话
Vue 2 已经在 2023 年 12 月 31 日停止维护,不再接收新功能、更新或安全修复。但存量项目并不会因为官方停止维护就自动消失。
根据 State of Vue.js 报告的数据,96% 的受访者在用 Vue 3,同时仍有超过 35% 的人在过去 12 个月里接触过 Vue 2.7,超过 25% 的开发者表示从 Vue 2 迁移到 Vue 3 的过程遇到过困难。
这意味着两件事。第一,新项目没有理由再从 Vue 2 开始。第二,老项目的迁移决策不需要被 Vue 4 的消息绑架。尤雨溪自己的建议也很直接:如果一个 Vue 2 项目“只是能跑、几乎不需要维护”,继续留着是可以的;如果还要长期加功能,再权衡迁移成本。
现在可以做什么
Vue 4 没有发布时间表,不需要现在就开始改代码。但有一件事值得提前做:把项目里对 CommonJS 的依赖摸清楚。
打开 package.json,看看有没有 "type": "module";全局搜一下 require(;检查构建配置文件是 .js 还是 .mjs / .mts。这些信息花十分钟就能整理出来,但它决定了 Vue 4 到来时你是从容切换,还是被卡在迁移队列里。
框架升级这件事,最怕的不是变化本身,而是变化来了才发现底层还压着一堆没拆的旧结构。Vue 4 已经明确不打算在 API 上折腾你,剩下的,就是你自己把模块格式的底子收拾干净。
本文内容仅供个人学习、研究或参考使用,不构成任何形式的决策建议、专业指导或法律依据。未经授权,禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载,请保留原文来源信息,不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持!