安裝
pnpm create vinext-app@latest my-app適合誰
這份技能適合已經在寫 Next.js、又想改走 Vite、並把 Cloudflare Workers 當作主要部署目標的人。官方把它寫成:在 Vite 上執行 Next.js 應用,首要落地環境是 Cloudflare Workers。它也適合準備在本機新建示例目錄、並能接受官方建立命令會寫入磁碟的人。
原文還寫明它能配合 Claude Code、OpenCode、Cursor、Codex 以及許多其他 AI 程式設計工具。這是一份示例名單,不能理解成只支援這四款。若你只做靜態頁、或部署目標根本不是 Workers,先停在閱讀說明。
它還不適合把現網生產應用當成「換一下就能跑」的對象。官方明確:今天能支撐不少有分量的 Next.js 應用,但還不是每一個應用或生產負載的即插即用替代。官方倉庫見 https://github.com/cloudflare/vinext 請按該頁已寫出的命令操作。
3 分鐘完成第一次嘗試
只走官方寫出的新建專案路徑。
前置條件:本機能執行 pnpm,目前目錄允許新建資料夾,並且你明確同意一次本地初始化。先確認:下面的命令會建立名為 my-app 的新目錄。若你還不想寫磁碟,不要執行。
安裝位置:在你準備放新專案的目錄開啟終端,確認上述副作用後執行:
pnpm create vinext-app@latest my-app
低風險核對:目錄出現後,先唯讀查看專案說明和設定,不要部署,也不要改現網倉庫。若你開啟的是既有 Next.js 專案,原文給出的下一句是在受支援的工具裡說 migrate this project to vinext;第一次嘗試請先停在「只複述這句話會改什麼」,不要讓工具直接改檔案。
成功訊號:目前目錄出現 my-app,並且能看出這是按 vinext 建出的 Next.js-on-Vite 專案。若命令失敗,不要自行補未出現的安裝器,回到官方頁面核對原文。
使用案例
案例一:從零建一個面向 Cloudflare Workers 的 Vite 版 Next.js 專案。官方命令是 pnpm create vinext-app@latest my-app。適合想先有一份可檢查的本地目錄、再決定是否繼續開發的人。動手前確認沒有同名資料夾;原文沒有寫出如何跳過安裝或改部署目標時,不要假設存在這類開關。
案例二:評估既有 Next.js 專案要不要遷到 vinext。原文寫明:在任一受支援的工具裡開啟該專案,並說 migrate this project to vinext。第一次請先讓工具列出它準備改哪些檔案,確認後再允許寫入。原文沒有給出遷移涵蓋的路由、資料取得或中介軟體清單,因此只能做到「按官方口令啟動評估」,不要把未寫出的相容表補全。
使用邊界
官方主路徑是 pnpm create vinext-app@latest my-app。不要把未出現的安裝器寫進主路徑。部署側原文只把 Cloudflare Workers 寫成首要目標,沒有證明可以原樣推到未點名的平台。
能力邊界寫得很清楚:今天能支撐不少有分量的 Next.js 應用,但還不是每一個應用或生產負載的即插即用替代。不要用它去承諾現網零改動切換。
工具名單是 Claude Code、OpenCode、Cursor、Codex 以及許多其他 AI 程式設計工具,屬於示例而非封閉名單。遷移口令只有一句被原文寫出;金鑰、環境變數和生產發布步驟原文沒有展開,不要補。官方頁面是 https://github.com/cloudflare/vinext 若工具建議的命令與該頁不一致,以該頁為準。