本页译自英文文档。命令、标识符和示例保持原样。运行时 7.24.4 · SDK 2.6.7。 英文原文

升级与恢复

状态：生效 范围：当前状态 最近审阅：2026-10-11 负责人：AX Code 维护者

下载和更新使用公开的 download.ax-code.com 源。不需要私有的 GitHub 令牌。请使用你已经在用的同一安装渠道。

独立安装器用户

升级之前先检查安装：

ax-code --version
ax-code doctor
ax-code upgrade check --method curl
ax-code upgrade --method curl

较旧版本可能没有 upgrade check，或仍会请求 GitHub 发布 URL。如果升级返回 404 或找不到发布，请再次运行当前的公开安装器。你不需要卸载 AX Code 或删除用户数据：

curl -fsSL https://download.ax-code.com/install | bash

在 Windows 上使用 PowerShell：

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

安装器会替换运行时文件；不要把删除配置、凭据、会话或项目状态当作升级步骤。更换版本之前请备份重要状态。手动脚本核验和固定版本见 安装与运行时渠道。单行命令会执行下载的安装器；运行时归档核验使用固定的 Minisign 密钥。Minisign 仍然是发布签名机制。

Homebrew 用户

使用共享 tap。已归档的旧 tap 包含 Homebrew 迁移映射。brew update 会为现有安装应用该迁移：

brew tap defai-digital/tap
brew trust defai-digital/tap
brew update
brew upgrade defai-digital/tap/ax-code

整 tap 信任覆盖该发布者的全部 formula、cask 和外部命令。见 旧 tap 迁移指南。如果 Homebrew 报告已安装版本已经是最新，则无需替换。除非你有意管理 PATH 上哪个启动器排在前面，否则不要混用 Homebrew 和独立安装。

确认活动启动器

ax-code --version
ax-code doctor
which -a ax-code

在 Windows 上，用 where.exe ax-code 代替 which -a。如果旧启动器被缓存，请重启 shell，或在 Unix 上运行 hash -r。PATH 上更早的旧可执行文件可以藏住一次成功的安装。移除任何东西之前先查看它的位置。

故障排除与回滚

阅读 发布回滚 以选择先前发布的版本。公开发布清单位于 download.ax-code.com/releases.json。安装帮助请使用 AX Code 社区。切勿在公开频道张贴凭据、私有源码或未脱敏的会话日志。