大家好，我是若川。持續組織了近一年的源碼共讀活動，感興趣的可以?點此加我微信ruochuan12?參與，每周大家一起學習200行左右的源碼，共同進步。同時極力推薦訂閱我寫的《學習源碼整體架構系列》?包含20余篇源碼文章。歷史面試系列。另外：目前建有江西|湖南|湖北籍前端群，可加我微信進群。

---

今天，Vue 正式發布了 2.7 版本， 版本名稱為 Naruto，即火影忍者。

盡管現在 Vue 3 是默認版本，但由于仍有許多用戶由于依賴兼容性、瀏覽器支持要求或沒有足夠的帶寬升級而不得不繼續使用 Vue 2。在 Vue 2.7 中，從 Vue 3 向后移植了一些最重要的功能，以便 Vue 2 用戶也可以從中受益。

向后移植的功能

• Composition API

• SFC <script setup>

• SFC CSS v-bind

此外，還支持以下 API：

• defineComponent()：具有改進的類型推斷（與Vue.extend相比）；

• h()、useSlot()、useAttrs()、useCssModules()；

• set()、del() 和 nextTick() 在 ESM 構建中也作為命名導出提供。

Vue 2.7 還支持在模板表達式中使用 ESNext 語法。使用構建系統時，編譯后的模板渲染函數將通過為普通 JavaScript 配置的相同 loaders / plugins。這意味著如果為.js文件配置了 Babel，它也將應用于 SFC 模板中的表達式。

注意事項

• 在 ESM 構建中，這些 API 作為命名導出提供（僅限于命名導出）：

import?Vue,?{?ref?}?from?'vue'Vue.ref?//?undefined,?改用命名導出

• 在 UMD 和 CJS 構建中，這些 API 作為全局 Vue 對象上的屬性暴露。

與 Vue 3 的行為差異

Composition API 使用 Vue 2 的基于 getter/setter 的響應式系統進行反向移植，以確保瀏覽器兼容性。這意味著與 Vue 3 的基于 proxy 的系統存在一些重要的行為差異：

• 所有 Vue 2 更改檢測警告仍然適用；

• reactive()、ref() 和 shallowReactive() 將直接轉換原始對象而不是創建代理：

//?在2.7中可行，在3.x中不可行
reactive(foo)?===?foo

• readonly() 確實創建了一個單獨的對象，但它不會跟蹤新添加的屬性并且不適用于數組；

• 避免在 reactive() 中使用數組作為 root 值，因為如果沒有屬性訪問，則不會跟蹤數組的變化（這將導致警告）；

• Reactivity APIs 忽略帶有 symbol 鍵的屬性。

此外，以下功能是未移植的：

• ? createApp()（Vue 2 沒有獨立的應用范圍）

• ? <script setup> 中的頂層 await（Vue 2 不支持異步組件初始化）

• ? 模板表達式中的 TypeScript 語法（與 Vue 2 解析器不兼容）

• ? Reactivity transform（仍處于試驗階段）

• ? options 組件不支持 expose 選項（但 <script setup> 支持 defineExpose()）。

升級指南

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，可能需要暫時將它保留在依賴項中，但是這個要求也將在新版本的 Test Utils 中被取消。

（3）檢查包管理器 lock 文件以確保以下依賴項滿足版本要求。它們可能是 package.json 中未列出的傳遞依賴項：

• vue-loader: ^15.10.0

• vue-demi: ^0.13.1

如果沒有，需要刪除 node_modules 和 lock 文件并重新安裝，以確保它們升級到最新版本。

（4）如果之前使用過 @vue/composition-api，請將其導入更新為 vue。注意，插件導出的一些 API，例如 createApp，未在 2.7 中移植。

（5）如果在使用 <script setup> 時遇到未使用的變量的 lint 錯誤，請將 eslint-plugin-vue 更新到最新版本 (9+)。

（6）Vue 2.7 的 SFC 編譯器現在使用 PostCSS 8。PostCSS 8 應該向后兼容大多數插件，但如果以前使用只能與 PostCSS 7 一起使用的自定義 PostCSS 插件，升級可能會導致問題。在這種情況下，需要將相關插件升級到與 PostCSS 8 兼容的版本。

Vite

Vue2.7 對 Vite 的支持是通過一個新插件提供的：@vitejs/plugin-vue2。這個新插件需要 Vue 2.7 或更高版本并取代現有的 vite-plugin-vue2。

注意，新插件不處理特定于 Vue 的 JSX / TSX transform，這是有意的。Vue 2 ?JSX / TSXtransform應該在一個單獨的專用插件中處理，該插件將很快提供。

Volar 兼容性

Vue 2.7 提供了改進的類型定義，因此不再需要安裝 @vue/runtime-dom 來支持 Volar 模板類型推斷。現在只需要在 tsconfig.json 中進行以下配置：

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

Devtools 支持

Vue Devtools 6.2.0 增加了對檢查 2.7 Composition API 狀態的支持，但擴展可能仍需要幾天時間在各個發布平臺上通過審核。

2.7 版本的影響

Vue 2.7 是 Vue 2.x 的最終次要版本。在這個版本之后，Vue 2 進入了 LTS（長期支持），從現在開始持續 18 個月，并且將不再接收新功能。這意味著 Vue 2 將在 2023 年底結束其生命周期。這應該為大多數生態系統遷移到 Vue 3 提供充足的時間。

額外細節

在準備此版本時，Vue 團隊將 Vue 2 代碼庫從 Flow 移植到了 TypeScript，這是基于核心團隊成員 @pikax 的努力。這樣更容易重用 Vue 3 中的代碼，并為移植的 API 自動生成類型定義。除此之外，還將單元測試從 Karma + Jasmine 移至 Vitest，從而大大提高了維護 DX 和 CI 的穩定性。

原文：https://blog.vuejs.org/posts/vue-2-7-naruto.html

·················?若川簡介?·················

你好，我是若川，畢業于江西高校。現在是一名前端開發“工程師”。寫有《學習源碼整體架構系列》20余篇，在知乎、掘金收獲超百萬閱讀。
從2014年起，每年都會寫一篇年度總結，已經堅持寫了8年，點擊查看年度總結。
同時，最近組織了源碼共讀活動，幫助4000+前端人學會看源碼。公眾號愿景：幫助5年內前端人走向前列。

掃碼加我微信 ruochuan12、拉你進源碼共讀群

今日話題

目前建有江西|湖南|湖北?籍 前端群，想進群的可以加我微信 ruochuan12?進群。分享、收藏、點贊、在看我的文章就是對我最大的支持