支援政策

套件管理器

核心 turbo 功能取決於 JavaScript 生態系統中的套件管理器及其工作區和鎖定檔格式的實作。

套件管理器	支援
pnpm 8+	是
npm 8+	是
yarn 1+	是 (包含 Yarn Plug'n'Play)
bun 1+	Beta

套件管理器有自己的發布時程、錯誤和功能。儘管我們有意跟上新的主要版本，但我們可能無法立即發布支援。

平台

turbo 一般支援基於 Debian 的 Linux 發行版、macOS 和 Windows，適用於 x86_64 和 ARM 64 架構。具體來說，我們透過 npm 建置和發布以下二進位檔

turbo-darwin-64 (搭載 Intel 晶片的 macOS)
turbo-darwin-arm64 (搭載 Apple Silicon 的 macOS)
turbo-linux-64
turbo-linux-arm64
turbo-windows-64*
turbo-windows-arm64*

*: 需要 Windows C Runtime Libraries

Node.js

核心 turbo 功能不取決於系統上啟用的 Node.js 版本，但 Turborepo 生態系統中的某些套件，例如 create-turbo、turbo-ignore 和 eslint-config-turbo 則會。對於這些功能，我們打算支援 Node.js 的 Active 和 Maintenance LTS 版本。

Turborepo 的範例也應與這些 Node.js 版本相容。

版本控制

我們支援使用 Git 進行版本控制的儲存庫，以及完全沒有版本控制的儲存庫。任何其他版本控制系統都將被忽略。

請注意，我們使用 Git 來雜湊檔案，因此沒有 git 的儲存庫效能和行為可能有所不同。

LTS 政策

Turborepo 的主要版本將在下一個主要版本發布日起支援兩年。

舊版本中關鍵安全性修復所需的變更將會向後移植。這種情況將會很少見，並且會以 semver-minor 版本發布，即使它們是重大變更。

我們強烈建議您盡可能使用最新版本的 Turborepo。

主要版本	發布日期	終止支援日期
2.x	2024 年 6 月 4 日
1.x	2021 年 12 月 9 日	2026 年 6 月 4 日

發布階段

Turborepo 的穩定版本遵循語意化版本控制 (semver)，並在發布前經過徹底測試。

Turborepo 也提供特定的 API，可能會在較早的開發階段發布。這是為了讓早期採用者提供寶貴的意見回饋，並幫助核心團隊在 API 穩定發布之前建立信心。預先穩定版本提供的 API 將在文件和 turbo 本身中標記，盡可能標記。

並非每個 API 都會在每個階段發布。我們會根據我們對功能的信心，使用最佳判斷來確定 API 的階段，權衡因素包括功能的複雜性、可能的用例以及早期 API 使用者的意見回饋。

Turborepo 核心團隊感謝任何早期使用功能的使用者，並對您提供的任何意見回饋表示感謝。

穩定

當 API 達到穩定性時，即表示已準備好在生產環境中使用。標記為穩定的 API 只會在主要版本中以向後相容的方式變更。

如果穩定的 API 將在即將到來的主要版本中有重大變更，將會提供警告和文件，以協助遷移和後續步驟。
如果穩定的 API 將在即將到來的主要版本中移除，它將被標記為已棄用，以便提前通知未來的移除。

Beta

Beta API 在穩定發布之前需要對可靠性更有信心。在 Beta 階段，我們對功能的整體設計充滿信心，並期望能夠在相對較少的變更下將功能升級為穩定版。在極少數情況下，API 可能需要重大變更，並且不受 semver 涵蓋。

我們鼓勵早期採用者使用 Beta API，以幫助我們更確信功能設計和穩定性。根據您的風險承受能力，您可以自行決定在生產環境中使用該功能。

目前處於 Beta 階段的 API

實驗性

實驗性 API 缺乏達到穩定性所需的必要功能。功能的設計被認為處於積極開發中，並且可能隨時變更。

我們鼓勵您在副專案、概念驗證和其他穩定性非必要的環境中幫助我們測試實驗性 API。這讓您有機會在功能開發時向核心團隊提供早期意見回饋，從而協助 API 的開發。我們不建議在可靠性至關重要的環境中使用實驗性 API。

目前處於實驗性階段的 API

已棄用

已棄用的 API 正在移除過程中。任何我們打算移除的功能都將包含現有使用者的文件，其中包含後續步驟以及預期移除功能的資訊。

目前已棄用的 API

TURBO_REMOTE_ONLY 和 --remote-only：使用 TURBO_CACHE 或 --cache