# 发布渠道 {#release-channels}

Tuist CLI 通过三个渠道分发，各自提供不同的稳定性保障。推荐安装的是 **stable** 渠道，更新节奏较慢：它不会在每次功能合并时都推进版本，因此升级不再意味着一次性吸收一批无关变更。早期使用者仍可在 **canary** 渠道运行按提交构建的版本，而 **release candidate** 渠道则让团队在版本稳定之前充分验证即将发布的分支。

## 各渠道 {#the-channels}

| 渠道 | 版本格式 | 发布频率 | 默认解析？ |
| --- | --- | --- | --- |
| Canary | `X.Y.0-canary.N`（例如 `4.201.0-canary.42`） | 每次向 `main` 提交 | 否 — 需显式选择 |
| Release candidate | `X.Y.0-rc.N`（例如 `4.200.0-rc.1`） | 每周一从 `main` 切出，验证约 1 周 | 否 — 需显式选择 |
| Stable | `X.Y.Z`（例如 `4.200.0`、`4.200.1`） | 经过充分验证后，每周一提升为稳定版 | **是** |

Canary 和 release candidate 构建以预发布形式发布。Mise 和 Homebrew 等工具在解析 `latest`、裸安装或分支绑定时会排除预发布版本，因此只有在你显式请求时才会使用它们。

### Canary {#canary}

每次向 `main` 提交都会发布一个 canary 版本。Canary 始终代表 **下一个未发布的小版本**：一旦某个分支被切出用于发布，`main` 就会推进到下一个小版本（例如，从 `4.200.0-canary.42` 到 `4.201.0-canary.1`）。如果你希望尽早获得最新信号，或者想在你报告或贡献的修复进入稳定版之前验证其行为是否符合预期，Canary 是合适的渠道。

### Release candidate {#release-candidate}

当一个小版本准备发布时，其分支会被冻结到受保护的 `releases/<major>.<minor>.x` 分支，并以 `X.Y.0-rc.1` 的形式发布。该分支处于功能冻结状态；只会挑选关键修复和回归修复，每接受一个修复就会递增 RC 版本号（`-rc.2`、`-rc.3`、…）。经过充分验证且无问题后，该分支会被提升为稳定版。

### Stable {#stable}

Stable 是推荐渠道，也是所有文档指向的渠道。只有当 release candidate 经过充分验证且无问题时，才会发布稳定小版本（`X.Y.0`），并且在新功能合并到 `main` 时，它 **不会** 推进版本。稳定分支上的补丁版本（`X.Y.1`、`X.Y.2`、…）仅包含回溯修复，绝不包含新功能。

## 选择版本 {#choosing-a-version}

使用 [Mise](/en/guides/install-tuist)（推荐）：

```bash
mise use tuist@latest              # Latest stable (recommended)
mise use tuist@4.200               # Pin to a stable line; receives backported fixes only
mise use tuist@4.200.1             # Pin to an exact stable patch
mise use tuist@4.201.0-rc.1        # Opt into a release candidate to soak it
mise use tuist@4.201.0-canary.42   # Opt into a specific canary build
```

使用 Homebrew 时，`brew install --formula tuist` 始终安装最新的稳定版；预发布版本不通过该公式分发。

## 推荐策略 {#recommended-strategy}

1. **绑定到一个稳定分支**，例如 `tuist@4.200`。该分支仅接收回溯修复，不包含新功能，因此日常升级风险较低。
2. **有计划地采用新功能。** 当你准备好使用下一个小版本时，先在 release candidate 渠道进行充分验证，然后将绑定切换到新的稳定分支。
3. 如果你是希望尽早获得最新信号的早期使用者，可以在非关键环境中 **尝试 canary**。

## 支持与回溯修复 {#support-and-backports}

任何时候都有两个稳定分支处于积极维护状态：

| 分支 | 接收 |
| --- | --- |
| 当前（`X.Y.x`） | 回归修复和安全修复 |
| 前一个（`X.(Y-1).x`） | 仅关键修复和安全修复 |
| 更旧版本 | 无 — 请升级到受维护的分支 |

修复首先合入 `main`（canary）。回归修复和安全修复会回溯到当前稳定分支，而前一个分支仅接收关键修复和安全修复。其他错误修复不会回溯；它们将随下一个小版本发布。当新分支被提升为稳定版时，原当前分支变为“前一个”，原“前一个”分支则停止接收回溯修复。

无论使用哪个渠道，Tuist 服务器都与过去 3 个月内发布的任何 CLI 保持 [兼容](/en/cli/compatibility)，因此只要你在该期间内升级，绑定到稳定分支就不会使你超出支持范围。