Vue 3 将在 2022 年 2 月 7 日成为新的默认版本
title: Vue 3 将成为新的默认版本 date: 2022-01-20T00:00:00.000Z author: 尤雨溪 gravatar: eca93da2c67aadafe35d477aa8f454b8 twitter: '@youyuxi' hidden: true theme: fancy
划重点:Vue 3 将在 2022 年 2 月 7 日成为新的默认版本!
请务必阅读可能需要采取的措施部分,来确认你是否需要在默认版本切换之前做相应改动以避免发生异常。
本文章开放授权,在注明原文地址,内容不做修改的前提下可以随意转载。
从库到框架
在最开始的时候,Vue 仅仅是一个运行时库。但这些年来,它已经逐步发展成了一个包含许多子项目的框架:
- 核心库,即
vue
npm 包 - 内容足够当作一本书的文档
- 构建工具链(Vue CLI、Vue Loader 和其他支持包)
- 用于构建单页应用的路由 Vue Router
- 用于状态管理的 Vuex
- 用于调试和分析的浏览器开发者工具扩展
- 用于支持开发单文件组件的 VSCode 扩展 Vetur
- 用于进行静态风格/错误检查的 ESLint 插件
- 用于组件测试的 Vue Test Utils
- 利用 Vue 运行时功能的定制 JSX Babel 插件
- 用于静态网站生成的 VuePress
正因为 Vue 是一个社区驱动的项目,才让这一切成为可能。这些项目中的许多都是由社区成员发起,他们后来成为了 Vue 团队的成员。其余的项目最初由我发起,但现在除了核心库之外,几乎都完全由团队维护。
Vue 3 的 “软发布”
随着核心库发布新的大版本,框架的所有其他部分也需要一起同步更新。我们还需要为 Vue 2 用户提供一个升级方案。对于 Vue 这样一个社区驱动的团队来说,这是一个巨大的工程。在 Vue 3 的核心库完成的时候,框架的其他部分要么还在 beta 状态,要么还没有开始适配 Vue 3。当时我们的决定是先发布核心库,这样早期用户可以先用起来,库和上层框架的开发者也可以先适配起来,而我们则继续更新框架的其余部分。
在这个过程中,我们依然将 Vue 2 保留为文档和 npm 安装时的默认版本。这是因为我们知道对于大部分用户来说,在 Vue 3 的其余部分完善以前,Vue 2 仍然提供了更一致且完整的体验。
崭新的 Vue
“软发布” 的过程比预期要长,但这个时刻终于到了:我们很高兴地宣布,Vue 3 将在 2022 年 2 月 7 日成为新的默认版本。
除了 Vue 核心库以外,我们还几乎改进了框架的每个方面。
- 基于 Vite 的极速构建工具链
<script setup>
带来的开发体验更丝滑的组合式 API 语法- Volar 提供的单文件组件 TypeScript IDE 支持
- vue-tsc 提供的针对单文件组件的命令行类型检查和生成
- Pinia 提供的更简洁的状态管理
- 新的开发者工具扩展,同时支持 Vue 2/Vue 3,并且提供一个插件系统来允许社区库自行扩展开发者工具面板。
我们还彻底重写了主文档。全新的 vuejs.org (目前处于待发布状态,中文版的翻译还在进行中) 将提供最新的框架概述与开发建议、针对不同背景的用户的灵活的学习路径,在整个指南与示例中都能够在选项式 API 和组合式 API 之间进行切换,以及许多新的深入章节。新文档本身的网站性能也非常优秀——我们将在不久后的另一篇博文中详细探讨一下。
版本切换细节
下面是我们所说的“新的默认版本”的具体细节。此外,请阅读可能需要采取的措施部分,来确认你是否需要在默认版本切换之前做相应改动以避免发生异常。
npm 发布标签
-
npm install vue
将默认安装 Vue 3。 -
所有其他官方 npm 包的
latest
发布标签将指向其 Vue 3 的兼容版本,包括vue-router
、vuex
、vue-loader
和@vue/test-utils
。
官方文档与站点
所有的文档和官方站点将默认切换到 Vue 3 版本。包括:
- vuejs.org
- router.vuejs.org
- vuex.vuejs.org
- vue-test-utils.vuejs.org (将迁移到 test-utils.vuejs.org)
- template-explorer.vuejs.org
请注意,新的 vuejs.org 将是完全重写的版本,而不是目前部署在 v3.vuejs.org 的版本。
这些站点当前的 Vue 2 版本将被迁移到新地址 (版本前缀表示库的各自版本,而非 Vue 核心库的版本):
- vuejs.org -> v2.vuejs.org (旧的 v2 网址将自动重定向到新地址上)
- router.vuejs.org -> v3.router.vuejs.org
- vuex.vuejs.org -> v3.vuex.vuejs.org
- vue-test-utils.vuejs.org -> v1.test-utils.vuejs.org
- template-explorer.vuejs.org -> v2.template-explorer.vuejs.org
GitHub 仓库
在写这篇文章时,仓库相关的变化已经生效了。
vuejs
组织下的所有 GitHub 仓库将把默认分支切换到 Vue 3 对应的版本。此外,以下仓库都将被重命名,以删除其名称中的 next
:
vuejs/vue-next
->vuejs/core
vuejs/vue-router-next
->vuejs/router
vuejs/docs-next
->vuejs/docs
vuejs/vue-test-utils-next
->vuejs/test-utils
vuejs/jsx-next
->vuejs/babel-plugin-jsx
此外,主文档的翻译仓库将被移至 vuejs-translations
组织下。
GitHub 会自动处理仓库的重定向,所以之前的源码与 issue 问题的链接应该仍然有效。
开发者工具扩展
开发者工具 v6 目前是发布到 Chrome Web Store 的 beta 频道下的,在版本切换后,将移至稳定频道。
目前的稳定频道仍然可用。它将被迁移到遗留频道。
可能需要采取的措施 {#potential-required-actions}
使用未指定版本的 CDN 链接
如果你通过 CDN 链接使用 Vue 2 而没有指定版本,请确保通过 @2
来指定一个版本范围:
```diff - +
- ```
注意:即使使用 Vue 3,你也应该始终在生产环境指定一个版本范围,以避免意外地加载到未来的大版本。
npm latest
标签
如果你使用 latest
标签或 *
来从 npm 安装 Vue 或其他官方库,请更新为明确使用兼容 Vue 2 的版本:
diff
{
"dependencies": {
- "vue": "latest",
+ "vue": "^2.6.14",
- "vue-router": "latest",
+ "vue-router": "^3.5.3",
- "vuex": "latest"
+ "vuex": "^3.6.2"
},
"devDependencies": {
- "vue-loader": "latest",
+ "vue-loader": "^15.9.8",
- "@vue/test-utils": "latest"
+ "@vue/test-utils": "^1.3.0"
}
}
- 技术周刊 2022-05-05:Chrome 将支持 inert 属性,Web Bundle 提案
- 技术周刊 2022-04-13:Chrome 100、React 18 发布
- 搞出一个 vue-element-admin 的 Vue3 版本 | 升级全过程记录
- 阿里妈妈又做了新工具,帮你把 Vue2 代码改成 Vue3 的
- 2022-03-29:npm 受供应链攻击,Shadow Realms 支持
- 技术周刊 2022-03-16:React 18 首个 RC 发布,数周后将发布正式版
- 技术周刊 2022-03-07: Cascade Layers 已支持,Chrome 100 将到来
- 升级 Vue3 的最后一块拼图,快试试这个工具自动升级你的 Element 老项目
- Vue 3 将在 2022 年 2 月 7 日成为新的默认版本
- NAPI-RS v2 发布
- 技术周刊 2021-12-20:React 18 终进 RC,SharedArrayBuffer 梅开二度
- 技术周刊 2021-12-10:OpenType 1.9 带来全新的彩色字体规范
- 技术周刊 2021-11-12:Angular 13 发版
- 技术周刊 2021-10-28:WebAssembly 全面开花
- 技术周刊 2021-10-15:Firefox 支持 AVIF
- 技术周刊 2021-09-07:WebGPU 进入 Chrome 初期试用
- 技术周刊 2021-07-16:Chrome 即将推出 HTTPS-First 模式
- 技术周刊 2021-06-08:React 18 和并发 SSR 支持就要来了
- iconfont 支持全新的彩色字体图标
- 技术周刊 2021-05-27:Node.js 跑在浏览器中是什么样,WebContainer 揭晓啦