Vue 3 | Vue 2.7 | 延长版 LTS

您正在浏览的是 Vue 2.x 的文档。Vue 3 的文档在这里

迁移至 Vue 2.7

Vue 2.7 是 Vue 2 最新的次级版本。其提供了内置的组合式 API 支持。

尽管 Vue 3 是当前的默认主版本,我们非常理解许多由于依赖的兼容性、浏览器的兼容性需求、或精力有限不足以完成升级等因素,仍然留在 Vue 2 的用户。在 Vue 2.7 中,我们从 Vue 3 移植回了最重要的一些特性,使得 Vue 2 用户也可以享有这些便利。

移植回来的特性

此外我们还支持了以下 API:

关于被导出的 API 的注意事项

与 Vue 3 的行为差异

组合式 API 使用了 Vue 2 中基于 getter/setter 的响应式系统,以确保浏览器的兼容性。这意味着其行为和 Vue 3 中基于代理的系统相比有一些重要的区别:

此外,我们并没有移植回以下特性:

升级指南

Vue CLI / webpack

  1. 将本地的 @vue/cli-xxx 依赖升级至所在主版本范围内的最新版本 (如有):

    • v4 升级至 ~4.5.18
    • v5 升级至 ~5.0.6
  2. vue 升级至 ^2.7.0。同时你可以从依赖中移除 vue-template-compiler——它在 2.7 中已经不再需要了。

    注意:如果你在使用 @vue/test-utils,那么 vue-template-compiler 需要保留,因为该测试工具集依赖了一些只有这个包会暴露的 API。

  3. 检查包管理工具的版本锁定文件,以确保以下依赖的版本符合要求。它们可能是间接依赖所以未必罗列在了 package.json 中。

    • vue-loader: ^15.10.0
    • vue-demi: ^0.13.1

    否则,你需要移除整个 node_modules 和版本锁定文件,然后重新安装,以确保它们都升到了最新版本。

  4. 如果你曾经使用了 @vue/composition-api,将其导入语句切换至 vue 即可。注意有些之前通过插件暴露的 API,例如 createApp,并没有被移植回 2.7。

  5. 如果你在 <script setup> 中遇到了未使用变量的 lint 错误,请更新 eslint-plugin-vue 至最新版本 (9+)。

  6. 2.7 的单文件组件编译器使用了 PostCSS 8 (从 7 升级而来)。PostCSS 8 应该向下兼容了绝大多数插件,但是该升级可能在你使用了一些只支持 PostCSS 7 的自定义插件时遇到问题。这种情况下,你需要升级相应的插件至其兼容 PostCSS 8 的版本。

Vite

2.7 通过一个新的插件提供对 Vite 的支持:@vitejs/plugin-vue2。这个新的插件需要 Vue 2.7 或更高版本,并取代了已有的 vite-plugin-vue2

注意这个新插件刻意不会处理 Vue 特有的 JSX / TSX 转换。在 Vite 中,Vue 2 的 JSX / TSX 转换是通过一个独立的插件进行处理的:@vitejs/plugin-vue2-jsx

Volar 兼容性

2.7 的发布改进了类型定义,所以我们不必再只为支持 Volar 的模板类型推断而安装 @vue/runtime-dom。你现在只需要在 tsconfig.json 中进行以下配置:

{
// ...
"vueCompilerOptions": {
"target": 2.7
}
}

开发者工具支持

Vue Devtools 6.2.0 已经支持了 2.7 组合式 API 状态的审查,但该扩展可能仍然需要几天时间在各自的发布平台上通过审核。

2.7 发布的后续

如我们之前所提到的,2.7 是 Vue 2.x 的最后一个次级版本。在此发布之后,Vue 2 将会进入长期技术支持 (LTS:long-term support) 状态,该状态从现在起计算会持续 18 个月,且不再提供新特性。

这意味着 Vue 2 的终止支持时间将会是 2023 年 12 月 31 日。我们相信这将为生态系统的绝大部分提供充足的时间迁移至 Vue 3。然而,我们也理解有些团队或项目可能无法在这个时间段内升级,同时还要满足安全和合规等要求。如果你的团队希望在 2023 年底之后继续使用Vue 2,请确保提前做好计划并了解你的可选项:了解更多关于 Vue 2 LTS 及其延长版服务