跳到正文
cloudflare blog(blog.cloudflare.com)· James Anderson·· 2026-09-28品質評分67

Vite 驅動的 Next.js 應用:Vinext 1.0 釋出

Next.js applications, powered by Vite: introducing Vinext 1.0

重點導讀

Cloudflare 推出 Vinext 1.0,幫助開發者將 Next.js 應用遷移到 Vite,並在 Cloudflare Workers、Netlify、AWS Lambda 等平臺部署。

新版相容率超過 99%,支援 App Router 與 Pages Router、ISR、快取、觀察等功能,並提供自動化測試與社群驅動的持續改進。

AI 伴隨問答

自備 Key 深度分析

針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:

正文 · 中文翻譯

當我們在二月 啟動 Vinext 時,這是一場大膽的為期一週的 AI 驅動實驗的結果,旨在看看一名工程師和一堆令牌能在多大程度上覆制由 Vite 支援的 NextJS 框架。

在那次實驗之後的七個月裡,Vinext 已成長為客戶信任並在高流量、動態應用的生產環境中執行的框架。

今天我們宣佈釋出 Vinext 1.0,這是我們讓 Next.js 應用能夠在任何地方部署的旅程中的最新一步。Vinext 讓你可以將任何 Next.js 應用(無論是為 Pages 還是 App Router 構建的)轉換為可移植的形式,部署到任何 Web 平臺,包括 Cloudflare Workers 免費計劃、Netlify 或 AWS Lambda。

Vinext 1.0 帶來了相容性、穩定性和快取行為的全面改進,併為專案的長期發展奠定基礎。現在正是將你的 Next.js 專案轉換為 Vinext 的最佳時機;只需執行 npx vinext check 和 npx vinext init。

升級到 1.0

釋出時 Vinext 很有前景,但並不完整。此後,我們花了大量時間改進 App Router 的相容性,並將其擴充套件到 Pages Router 應用——我們瞭解到許多客戶長期以來一直是 Pages Router 的忠實粉絲,擁有大型且遷移複雜的應用。我們不想讓 Vinext 成為僅適用於使用最新 App Router 功能的人的工具。

我們的重點是同時支援這兩種路由器,並密切關注我們的測試相容性,對於大多數重要的客戶需求功能,其相容率已超過 99%。

這一改進得益於圍繞我們 GitHub 專案 的社群。Vinext 一推出,該社群就將其應用於各種應用程式,以發現差距。在他們的審查下,我們發現了一些在測試覆蓋範圍中不易立即顯現的挑戰。Vinext 必須完全按 Next.js 的行為執行。僅僅模仿同名函式是不夠的。構建一個替代的 import { revalidatePath } 還算簡單;難點在於確保它正確影響渲染頁面、快取條目和後續請求。

跟蹤請求通過應用程式,確保 Vinext 按預期響應——不僅複製 API,還複製這臺機器的行為——無疑是更具挑戰性的方面。

一旦我們修復了問題並推出新功能,保持不回退尤為重要,尤其是當 Next.js 做出更改時。這就是我們構建測試套件的原因:數千個聚焦測試覆蓋了兩種路由器、開發和生產伺服器以及 Node.js 和 Cloudflare Workers 的部署目標的核心框架行為。我們還在每晚對 Vinext 執行 Next.js 的端到端測試套件,為我們提供持續的相容性視窗,並確保我們能立即發現由合併更改引起的回退。除了自動化測試,我們還直接與在生產環境中使用 Vinext 的大型客戶合作,確保他們沒有遇到問題。

1.0 包含哪些內容

我們從使用 Vinext 的客戶那裡得到的最清晰的資訊是,某些 Next.js 功能已經包含在框架中,Vinext 並不需要做 所有 Next.js 在最近版本中推出的功能,才能對他們極其有用。因此我們專注於在你需要的地方提供更好的支援:

  • App Router、Pages Router 與混合應用: 我們聽到客戶說 Pages Router 仍然重要,遷移不是一步完成的。Vinext 因此支援兩種路由路徑,包括 React Server Components、Server Actions、API 路由、路由處理器、middleware 和客戶端導航。
  • 完整的頁面生命週期: 頁面可以以多種方式渲染:在伺服器上、在構建時預渲染、匯出為靜態資源,或使用頁面級 Incremental Static Regeneration (ISR) 快取。我們已確保後臺和按需重新驗證與任何輸出都相容。
  • 快取: Vinext 在 App Router、Pages Router 以及支援的執行時之間共享一套快取函式。我們還支援使用 Cloudflare 的 Workers Cache。
  • 可觀測性: Vinext 在兩種路由中提供相容 Next.js 的追蹤,因此現有的 OpenTelemetry 和 Sentry 設定仍可正常工作。在 Cloudflare Workers 上,追蹤還可與原生 Workers Observability 整合。
  • Next.js 生態系統相容性: Vinext 實現了公共 next/* 介面,並支援常見的 Next 模式,用於身份驗證、MDX、影像最佳化、字型、後設資料、環境變數等。
  • 對 Workers 的一流執行時支援: 雖然 Vinext 可以在任何地方執行,伺服器程式碼可以在開發和生產環境中運行於 Cloudflare workerd 執行時,並直接訪問影像最佳化、hyperdrive 等繫結。

我們還將遷移納入框架:只需執行兩條命令即可驗證您的 Next.js 安裝及任何修改是否相容,並在保留所有原有 Next.js 專案結構的同時設定 Vite 和部署配置。

當我們與團隊討論哪些功能對他們重要時,出現了一個突出點。Next.js 16 認為 Cache Components 是框架未來的重要組成部分,但我們談到的大多數團隊並未使用它們,也不認為支援是遷移的前提。因此,Vinext 目前對驅動 Cache Components 的 “use cache” 指令支援有限,雖然我們會繼續改進相容性,但我們更專注於上述核心優先順序。

預渲染與快取預熱

當我們首次宣佈 Vinext 時,它支援在首次請求後進行 Incremental Static Regeneration (ISR),但尚未在構建期間渲染頁面。應用使用 generateStaticParams() 和 getStaticPaths() 來識別在構建時應渲染的頁面,並期望頁面級 ISR 將這些初始響應與後臺和按需重新驗證連線。

Vinext 1.0 支援兩種路由的該生命週期。它可以在構建期間預渲染 App Router 和 Pages Router 路由,通過頁面級 ISR 提供這些響應,並可按路徑或標籤失效。它還支援輸出:當您想要的結果是完全靜態站點時,使用 "export"。

但這讓我們產生了疑問:為什麼渲染需要在構建期間進行?

擁有數萬甚至數十萬可能 URL 的網站,可能會在渲染流量很少的頁面上耗費大量時間。構建過程無法評估大多數網站所經歷的長尾流量,因此無法將計算時間集中在更少但更關鍵的頁面上。相反,你會浪費數小時等待順序構建逐頁完成,已遠在最重要路由完成之後。

快取預熱是我們的解決方案,將頁面預渲染從構建機器遷移到 Cloudflare 的網路。開發者可以繼續使用 Next.js 原語來識別需要預渲染的頁面,Vinext 還能額外識別高流量頁面並加入此列表。這一過程在你的網站部署到生產環境之前在後臺完成,確保一旦上線即可快速從 Cloudflare 快取提供響應。

在部署過程中,這一步是通過上傳新的 Worker 版本並將其部署到 0% 的生產流量,然後專門從該版本請求頁面。這樣可以在任何真實使用者訪問新部署之前讓渲染管道先行工作。快取填充完成後,部署即可安全提升。

接下來我們要做的

如果最初的實驗創造了單次的 slopfork,後續更重要的部分是我們如何讓這一自我改進過程持續無限執行。

該專案現在專注於讓框架與上游的所有變更保持同步。Next.js canary 每天都會收到新的提交。每天早上,代理會審查更改,獲取差異,併為任何可能影響 Vinext 的事項開啟跟蹤問題。每晚,我們在對 Vinext 執行 Next.js 測試套件後重新生成相容性矩陣。

當這些測試或問題之一揭示缺口時,代理現在能夠在兩個程式碼庫中識別更改,構建重現,遷移任何相關測試,並提出修復方案。

此審查已捕捉到缺失案例、不安全的快取行為,以及開發與生產伺服器之間的差異。

自動化幫助我們將活動流縮小為值得關注的重點變更,使專案維護者僅關注那些需要了解流程如何從 Next.js 實現對映到 Vite 的問題。

我們正在 Cloudflare 建立一個開源軟體工廠,你可以在 GitHub 上檢視我們的進展。

試一試

Vinext 可用於新的應用程式以及現有的 Next.js 專案。

今天開始一個新應用:

或者遷移現有應用:

然後將其部署到 Cloudflare Workers,並使用我們的快取預熱:

訪問 vinext.dev 獲取文件、示例和當前相容性矩陣。Vinext 是開源的,託管在 github.com/cloudflare/vinext。歡迎提交問題、拉取請求、應用重現和反饋。

來源: cloudflare blog (blog.cloudflare.com)
開啟原文

讀者討論

理性交流 · 即時討論