# 兼容性 {#compatibility}

Tuist CLI 会与 Tuist 服务器通信，以使用缓存、构建和测试洞察、预览以及注册表等功能。服务器会持续独立地发布更新，不受你升级 CLI 的时间影响，因此服务器的变更不得破坏你正在运行的 CLI 版本。为确保这一点，服务器会在定义的时间窗口内保持与近期 CLI 版本的兼容性。

## 支持时间窗口 {#support-window}

Tuist 服务器支持来自**最近 3 个月**的 CLI 版本。在该窗口期内，服务器保持向后兼容：过去 3 个月内发布的任何 CLI 都能继续针对服务器进行构建、缓存和运行测试，你可以按自己的计划升级 CLI，而不会因服务器变更导致中断。

CLI 遵循[语义化版本控制](https://semver.org)。最近 3 个月内发布的任何版本都受支持。

## 超出时间窗口 {#outside-the-window}

早于支持时间窗口的 CLI 版本被视为已弃用。服务器仍会响应，但：

- 较新的服务端功能可能无法在该版本上正常工作。
- 由服务器支持的命令可能会输出警告，提示你升级。

不保证已弃用版本的行为。如果你正在使用此类版本，请升级到支持时间窗口内的版本。

## 我们如何兑现承诺 {#how-we-keep-the-promise}

向后兼容性经过验证，而非假设。每次服务器部署都会针对**仍处于支持时间窗口内的最旧 CLI 版本**（当前为`4.150.0`）运行自动化验收测试，端到端地执行缓存拉取流程。如果某项变更会破坏该版本，部署将在进入生产环境之前被阻止。该测试会与针对最新 CLI 的测试并行运行，因此能够以相同的方式捕获针对旧客户端和新客户端的回归问题。

## 建议 {#recommendation}

至少每 3 个月升级一次 CLI，以保持在受支持的时间窗口内。在 CI 中固定 CLI 版本并按固定节奏更新，可确保你的团队始终使用一致且受支持的版本。
