Nuxt 4 路線圖

我們最初計劃在 2024 年 6 月釋出 Nuxt 4，但事情並不總是按計劃進行。我認為採取不同的方法是合適的

👉 Nuxt 4 於 2025 年 7 月 8 日進入釋出候選 (RC) 階段，穩定版即將釋出。Nuxt 5 將在 Nitro v3 準備就緒後釋出。

為什麼分兩次釋出？

老實說，事後看來，我認為我們去年就應該釋出 Nuxt v4。這與我們每年釋出一次重要版本的計劃會更吻合。

另一方面，透過啟用 Nuxt 4 相容模式，它允許在無數專案中進行測試。我認為我們應該繼續釋出這些更改作為 Nuxt v4，原因有二：

1. 人們已經在使用了。我經常聽說有團隊在生產環境中使用 compatibilityVersion: 4。這個選項原本只用於測試，但它已被證明足夠穩定，可以用於生產。我們希望使其正式化，併為這些團隊提供穩定版本的保護。
2. 它將改善遷移。分兩階段從 v3 -> v4，然後再從 v4 -> v5 遷移，將使遷移過程更順暢。我們還沒有 Nitro v3 的最終破壞性更改列表，這意味著我們可以花足夠的時間確保 Nitro 升級順利進行，同時不延遲採用我們去年計劃的 Nuxt 更改。

更重要的是，未來我們將盡最大努力將 Nuxt 釋出與我們的關鍵依賴項（如 Vite 或 Nitro）解耦。

包含哪些內容？

Nuxt 4 包含您一直在用 compatibilityVersion: 4 測試的所有功能

• 🗂️ 新的目錄結構 - 程式碼放在 app/ 中，以便更清晰的組織和更好的 IDE 效能
• 🔄 改進的資料獲取 - 更智慧的 useAsyncData 和 useFetch，具有更好的快取和清理功能
• 🏷️ 一致的元件名稱 - Vue DevTools 和 <KeepAlive> 現在看到的名稱與 Nuxt 的自動匯入相同
• 📄 增強的 Head 管理 - 淘汰 Unhead v2 中已棄用的功能，具有更好的效能和標籤最佳化

...以及升級指南中記錄的許多其他改進。我們還將釋出一些進一步的更改，包括

• 採用 Vite 環境 API 的準備工作（帶一個開發伺服器）
• 改進型別“環境”處理（用於伺服器、客戶端和共享程式碼）

Nitro 怎麼樣？

我們不會延遲採用 Nitro v3。我們的目標是讓 Nuxt 5 和 Nitro v3 在我們最初計劃的同時釋出，即使那只是 Nuxt v4 釋出後的幾個月。

儘管過去一年有所延遲，但我們看到 Nitro 取得了驚人的進展。作為一個整體團隊，我們非常高興能揭示我們在 Nitro v3 和 h3 v2 中計劃的內容。

雖然 Nuxt 4 最初不會包含這些升級，但並行釋出 Nuxt v4 和 Nitro v3 意味著我們可以在 Nuxt 5 到來之前，在整個生態系統中更徹底地測試 Nuxt 和 Nitro。

Nuxt 3 怎麼樣？

Nuxt 4 第一個穩定版釋出後，我們將繼續為 Nuxt 3 提供維護和支援，並在 Nuxt 5 釋出後繼續支援 Nuxt 3 和 Nuxt 4。我們特意為這些版本選擇了稍短的六個月支援時間表，因為我們相信這將是一個直接的升級。

（我升級 Nuxt 4 的主要目的是確保它儘可能順暢。）

儘管如此，我將密切關注生態系統遷移的成功程度和速度。如果出現問題，我絕對會延長六個月的持續維護視窗。我們不想讓任何人掉隊。

一段時間內，這將意味著對三個版本進行積極的功能和錯誤修復反向移植。但我認為這是值得的。畢竟，我們過去一年一直在為 Nuxt 4 做準備。

接下來

Nuxt v4 現已進入 釋出候選 (RC) 階段！我們希望早期採用者進行測試。請向 Nuxt 或您可能正在使用的任何模組報告問題。

以下是您在未來幾周內可以期待的內容

• 我們計劃在nuxt/modules登錄檔中開啟社群模組的上游 PR，併為模組作者建立遷移指南。
• 我們將為 Nuxt 3 使用者建立一份完整的升級指南，包括破壞性更改列表以及如何遷移。（當前的升級指南解釋瞭如何啟用相容模式，但與 Nuxt 4 存在一些差異。）
• 我們本月將只發布 v3 的錯誤修復，將新功能的反向移植推遲到 v4 釋出之後。
• 我們將更新 nuxt.com 上的文件，以允許在 3.x、4.x 和（很快）5.x 文件之間切換。
• 隨著釋出候選版現已上線，我們目前只專注於錯誤修復。預計不會有新功能或破壞性更改。
• v4 釋出後，我們將把 main 分支分離到 4.x，以採用 h3 和 nitro 的邊緣版本，並開始開發 Nuxt 5。

我對這個時間表感到非常興奮——感謝您過去一年的耐心和信任！