Node.js 版本管理

定義

在專案與部署環境中明確指定 Node.js 版本，確保建置與執行環境一致。常見手段包括 .node-version 檔案、.nvmrc、engines 欄位等。

關鍵數據點（附來源）

• Cloudflare Pages 預設使用 Node 18，Astro 5 需要 Node 22 以上，透過 .node-version 檔案解決。（cloudflare-pages-preview-access）
• OpenClaw 也需要 Node.js 22 以上。（openclaw-telegram-setup）

前提與局限性

• 各部署平台對版本指定檔案的支援不同（.node-version、.nvmrc、環境變數等）。
• 版本升級可能引入 breaking changes，需搭配測試驗證。

衝突標記

（無）

關聯概念

• [[Cloudflare Pages]]
• [[自動化測試]]