Vue 3 将成为新的默认版本，特别提醒注意这些~

Vue 3 将于 2022 年 2 月 7 日成为新的默认版本，开发者需重点关注版本切换细节及兼容性调整措施，以避免异常。 以下是具体说明：

• npm 安装默认指向 Vue 3

  执行 npm install vue 将默认安装 Vue 3，其他官方库（如 vue-router、vuex、vue-loader、@vue/test-utils）的 latest 标签也会指向 Vue 3 兼容版本。

  若需继续使用 Vue 2，需显式指定版本号，例如：

  "dependencies": { "vue": "^2.6.14", "vue-router": "^3.5.3", "vuex": "^3.6.2"}

• 官方文档与站点迁移

  主文档站点

  http://vuejs.org
  将切换为全新重写的 Vue 3 版本（中文翻译进行中），原 Vue 2 文档迁移至
  http://v2.vuejs.org
  （自动重定向）。

  其他子项目文档地址变更：

  http://router.vuejs.org
  →
  http://v3.router.vuejs.org
  http://vuex.vuejs.org
  →
  http://v3.vuex.vuejs.org
  http://vue-test-utils.vuejs.org
  →
  http://v1.test-utils.vuejs.org

• GitHub 仓库调整

  默认分支切换至 Vue 3 对应版本，仓库名称移除 next 后缀（如 vuejs/vue-next → vuejs/core）。

  主文档翻译仓库移至 vuejs-translations 组织，GitHub 自动处理重定向，旧链接仍有效。

• CDN 链接需指定版本

  若通过 CDN 引入 Vue 2 且未指定版本，需添加 @2 标签以锁定版本，避免自动升级至 Vue 3：

  <!-- 修改前 --><script src="
  https://unpkg.com/vue"></script><
  !-- 修改后 --><script src="
  https://unpkg.com/vue@2"></script>

  生产环境建议：即使使用 Vue 3，也应指定版本范围（如 vue@^3.2.0），防止未来大版本意外加载。

• npm 依赖版本锁定

  检查 package.json 中依赖项的版本号，确保与 Vue 2 兼容：

  "devDependencies": { "vue-loader": "^15.9.8", // Vue 2 兼容版本 "@vue/test-utils": "^1.3.0" // Vue 2 兼容版本}

• 开发者工具更新

  开发者工具 v6 将从 Chrome Web Store 的 beta 频道移至 稳定频道，原稳定频道工具迁移至 遗留频道，用户需手动升级以支持 Vue 3。

• 开发体验优化

  基于 Vite 的构建工具链：显著提升构建速度。

  <script setup> 语法：简化组合式 API 的代码编写。

  Volar IDE 支持：为单文件组件提供 TypeScript 类型推断。

  vue-tsc 命令行工具：支持单文件组件的类型检查与代码生成。

• 状态管理与生态

  Pinia 替代 Vuex：提供更简洁的状态管理方案。

  新版开发者工具：同时支持 Vue 2/Vue 3，并开放插件系统供社区扩展。

• 文档与学习资源

  全新主文档

  http://vuejs.org
  提供灵活的学习路径，支持选项式 API 与组合式 API 示例切换，新增深入技术章节，网站性能显著优化。

• 迁移成本评估：若项目依赖 Vue 2 特有功能（如 Options API 深度使用），需评估迁移至 Vue 3 的成本，或通过 @vue/compat 构建兼容版本逐步过渡。
• 社区资源跟进：关注 Vue 官方博客及社区讨论，及时获取工具链（如 Vetur、ESLint 插件）的 Vue 3 适配进展。
• 测试覆盖：在版本切换前，确保测试用例覆盖核心功能，避免因 API 变更导致异常。

参考链接：

• 原文公告
• Vue 3 官方文档（待发布）
• Vue 2 文档存档