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 伴隨問答
針對這篇報導有疑問?可直接點選快捷問題或向 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。歡迎提交問題、拉取請求、應用重現和反饋。