Cloudflare Workers 的 Node.js 相容改預設開啟：相容日期 2026-08-04 起不必再加 nodejs_compat

一句話看懂：Cloudflare 宣布，Workers 的相容日期設為 2026-08-04 或更新時，會預設啟用 Node.js 相容，node:crypto、node:fs、node:http 這些內建 API 不用再手動開旗標就能用。

先用白話講：Workers 與 Node.js 相容是什麼？

Workers 是 Cloudflare 讓你把程式碼放到全球各地機房執行的服務。但它的執行環境不是 Node.js，而是自己的一套，所以很多為 Node.js 寫的函式庫，原本會因為「找不到某個內建功能」而跑不起來。

Node.js 相容就像一個轉接頭：把 Node.js 的內建功能（加密、檔案、網路、串流……）接到 Workers 的環境上，讓 npm 上的套件可以直接用。以前這個轉接頭要自己插上去，現在新的設定預設就插好了。

發生什麼事

Cloudflare 在 8 月 4 日的更新日誌宣布：

• 當 Workers 的相容日期是 2026-08-04 或更新，會預設啟用 nodejs_compat 與 nodejs_compat_v2 兩個旗標的行為
• Workers 執行環境支援的 Node.js 內建 API 都預設可用，包含 node:crypto、node:buffer、node:stream、node:net、node:dns、node:fs、node:http 等
• 依賴這些 API 的 npm 套件，不用額外設定就能運作

哪些人會被影響？

給開發者的技術細節

官方給的關閉設定長這樣（日期請改成你要的相容日期）：

{
  "compatibility_date": "2026-08-04",
  "compatibility_flags": ["no_nodejs_compat", "no_nodejs_compat_v2"]
}

• 官方說明 Wrangler、Miniflare、Cloudflare Vite 外掛與 Vitest Pool Workers，都會忽略這兩個已多餘的旗標
• 把相容日期往後調之前，建議先在測試環境跑一遍：新的相容日期可能還包含其他行為變更，這則公告只談 Node.js 相容的部分
• 內建 API「可用」不代表每個行為都和真正的 Node.js 完全一樣，細節請看官方的 Node.js 相容文件

我的看法

這個改變很貼心：以前新手遇到的第一個坑，常常是裝了一個很普通的 npm 套件，部署後卻跳出「找不到某個 node: 模組」，才發現要加旗標。現在新專案預設就沒有這個坑。

但「預設開啟」也有一個副作用：你的 Worker 現在能引入更多本來引入不了的套件，bundle 可能變大、啟動時間也可能受影響。我會建議在更新相容日期之後，順手看一下部署後的大小與冷啟動表現，不要只看功能有沒有跑起來。

名詞小辭典

• Workers：Cloudflare 的無伺服器執行環境，程式會在離使用者近的機房執行。
• 相容日期（Compatibility date）：用日期固定 Workers 執行環境行為的設定。
• npm：JavaScript 的套件管理平台，上面有大量現成的函式庫。
• Wrangler：Cloudflare 提供的命令列工具，用來開發與部署 Workers。

資料來源

• Cloudflare Changelog：Node.js compatibility is now enabled by default（2026-08-04）