本頁譯自英文文件。指令、識別名稱與範例保持原樣。執行環境 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 回報已安裝的版本已是最新，就不需要取代。不要混用 Homebrew 與獨立安裝，除非你刻意管理 PATH 上哪一個啟動器先出現。

確認作用中的啟動器

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

在 Windows 上，用 where.exe ax-code 取代 which -a。若舊的啟動器被快取，請在 Unix 上重新啟動殼層，或執行 hash -r。PATH 上較前面的舊執行檔，可能把成功的安裝藏起來。移除任何東西之前，請先查看它的位置。

疑難排解與回復

閱讀 發行回復，以選擇先前已發行的版本。公開的發行清單在 download.ax-code.com/releases.json。安裝方面的協助，請用 AX Code 社群。絕不要在公開頻道貼上憑證、私有原始碼，或未遮罩的工作階段日誌。