跳转到主要内容
在 Windows 上使用 WinGet 安装 XBOX CLI,在 Linux 或 macOS 上使用安装脚本安装,或者在任何平台上从发布存档安装。若要改为从源代码生成,请参阅 从源代码生成。

Windows:使用 WinGet 安装

在 Windows 上,使用 Windows 程序包管理器 WinGet 安装 CLI:
WinGet 会将 xbox 添加到你的 PATH,并且不需要管理员权限。如果安装后终端找不到 xbox,请打开新的终端;如果你使用 IDE 的集成终端,请重启 IDE。 若要更新 CLI:
若要删除它:
卸载后,你已保存的设置和登录数据会保留在 %LOCALAPPDATA%\XboxDevCLI 中。只能使用 WinGet 更新 WinGet 安装,而不能使用本页中的 ZIP 步骤。请继续执行 后续步骤。

Linux 和 macOS:使用脚本安装

在 Linux x64 或 macOS 上,安装脚本会将最新版本下载到 ~/.local/opt/xboxdevcli,并在 shell 的启动文件中将该目录添加到你的 PATH。 它需要 curl 和 unzip:
该脚本会输出它更改的启动文件。打开新的终端,然后使用 xbox --version 检查版本。若要更新 CLI,请再次运行该脚本。若要删除它,请删除 ~/.local/opt/xboxdevcli 以及脚本添加到该启动文件中的那一行。

下载版本

当 WinGet 和安装脚本都不适用时(例如在没有 WinGet 的 Windows 电脑上),请从发布存档安装。 从 GitHub 发布页面下载适用于你的操作系统和 CPU 的存档: Linux x64 二进制文件需要 glibc 2.27 或更高版本。macOS 二进制文件由 Microsoft 签名并经过 Apple 公证。你无需安装 .NET。 将整个存档解压缩到一个新的独立目录中,并按照适用于你的平台的步骤将该目录添加到你的 PATH。如果该目录中已有安装,请改为按照 更新 ZIP 安装进行操作。

Windows (PowerShell)

  1. 解压缩存档,并检查解压出的可执行文件:
  2. 将该目录添加到你的 PATH。从 Windows 搜索中打开编辑帐户的环境变量。在用户变量下,编辑 Path,选择新建,然后输入该目录,例如 C:\Users\<you>\AppData\Local\Programs\XboxDevCLI。
  3. 打开新的终端,然后检查版本:

Linux 和 macOS(Bash 或 Zsh)

  1. 解压缩存档,并检查解压出的可执行文件。此示例使用 Linux x64;在 macOS 上,对于 Apple 芯片,请使用 xbox-osx-arm64.zip,对于 Intel,请使用 xbox-osx-x64.zip:
  2. 将该目录添加到你的 PATH。对于 Zsh(macOS 上的默认 shell),请将此行添加到 ~/.zshrc;对于 Bash,请将其添加到 ~/.bashrc:
  3. 打开新的终端,然后检查版本:

验证安装

xbox --version 会显示你所下载版本的版本号,不含标记开头的 v。 如果显示的是较旧的版本,则说明你的 PATH 中有另一个 xbox 副本排在前面。请在 PowerShell 中使用 Get-Command xbox -All,或在 Bash 或 Zsh 中使用 type -a xbox 找到它,然后将其从你的 PATH 中删除。

检查更新

xbox upgrade 会告诉你是否有更新的版本,以及如何安装它。请参阅 Upgrade。
若要更新 WinGet 安装,请运行 winget upgrade Microsoft.Gaming.XBOXDeveloperCLI。若要更新脚本安装,请再次运行安装脚本。若要更新 ZIP 安装,请按照下一节进行操作。

更新 ZIP 安装

你已保存的设置和登录数据与安装分开存储,因此会被保留。 请参阅值的保存位置。
  1. 从 xbox upgrade 显示的发布页面或 GitHub 发布页面下载新版本的存档,并将其解压缩到新目录中。
  2. 关闭所有正在运行的 xbox 进程。
  3. 用新的安装目录替换旧的安装目录(使用相同的路径),或者按照 Windows (PowerShell) 或 Linux 和 macOS(Bash 或 Zsh)中的说明,将你的 PATH 条目更改为新目录。
  4. 打开新的终端,然后检查 xbox --version 是否显示新版本。
在新版本正常工作之前,请保留旧目录,但将其从你的 PATH 中移除。如果你的登录已过期,请再次运行 xbox auth login。

后续步骤

  • 入门:登录、选择你的 Partner Center 卖家并列出其游戏。
  • 命令:完整的命令参考。
  • 遥测:CLI 收集的内容以及如何将其关闭。
最后修改于 2026年11月19日