支持政策

包管理器

核心 turbo 功能依赖于 JavaScript 生态系统中的包管理器及其工作区和 lockfile 格式的实现。

平台

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 运行时库

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。

发布阶段

Turborepo 的稳定构建遵循语义版本控制 (semver)，并在发布前经过全面测试。

Turborepo 还提供特定的 API，这些 API 可能会在开发的早期阶段发布。这是为了让早期采用者提供有价值的反馈，并帮助核心团队在 API 稳定发布之前对其建立信心。预稳定版本中可用的 API 将在文档和 turbo 本身中尽可能地标记出来。

并非每个 API 都会在每个阶段发布。我们根据我们对功能的信心，使用最佳判断来确定 API 的阶段，权衡因素包括功能的复杂性、可能的用例以及早期用户的反馈。

Turborepo 核心团队感谢任何早期使用功能的用户，并感谢您提供的任何反馈。

稳定版

当 API 达到稳定状态时，它被认为可以用于生产环境。标记为稳定的 API 只会在主要版本中以向后兼容的方式进行更改。

• 如果一个稳定的 API 在即将到来的主要版本中将要进行破坏性更改，将提供警告和文档，以帮助进行迁移和后续步骤。
• 如果一个稳定的 API 在即将到来的主要版本中将要移除，它将被标记为已弃用，以便提前通知未来的移除。

Beta

Beta API 在稳定发布之前需要更高的可靠性信心。在 Beta 阶段，我们对功能的整体设计充满信心，并期望能够通过相对较少的更改将功能提升为稳定版。在极少数情况下，API 可能需要破坏性更改，并且不受 semver 约束。

我们鼓励早期采用者使用 Beta API，以帮助我们获得对功能设计和稳定性的确定性。根据您的风险承受能力，您可以根据需要将该功能用于生产环境。

当前处于 Beta 阶段的 API

• 无

实验性

实验性 API 缺乏达到稳定状态所需的基本功能。该功能的设计被认为正在积极开发中，并且可能随时更改。

我们鼓励您在副项目、概念验证和其他非必要稳定性的环境中使用实验性 API 来帮助我们进行测试。这使您有机会通过在功能开发过程中向核心团队提供早期反馈来帮助 API 的开发。我们不建议在可靠性至关重要的环境中使用实验性 API。

当前处于实验性阶段的 API

• turbo query
• turbo boundaries 和 标签
• --experimental-write-cache 用于 turbo watch
• --output=json 用于 turbo ls --affected 标志

已弃用

已弃用的 API 正在被移除过程中。任何我们打算移除的功能都将包含现有用户的文档，其中包含后续步骤以及有关何时移除该功能的信息。

当前已弃用的 API

• TURBO_REMOTE_ONLY 和 --remote-only: 使用 TURBO_CACHE 或 --cache