你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure Command-Line 接口（CLI）是一种跨平台命令行工具，可在 macOS 计算机上本地安装。 可以使用 Azure CLI 连接到 Azure，并使用交互式命令行提示或脚本在 Azure 资源上执行管理命令。
对于 macOS 平台，请使用 homebrew 包管理器安装 Azure CLI。 Homebrew 可以轻松地使 Azure CLI 的安装保持最新。 Azure CLI 包需要 macOS 13 或更高版本。
Azure CLI 的当前版本为 2.76.0。 有关最新版本的信息，请参阅发行说明。 若要查找已安装的版本并查看是否需要更新，请运行 az 版本。
使用 Homebrew 安装
Homebrew 是管理 Azure CLI 安装的最简单方法。 它可以方便地进行安装、更新和卸载。 如果系统中没有可用的 Homebrew，请先安装 Homebrew，然后继续。
在 macOS 上安装 Azure CLI 时，可以先更新 brew 存储库信息，然后运行 install 命令：
brew update && brew install azure-cli
故障排除
如果在通过 Homebrew 安装 Azure CLI 时遇到问题，下面是一些常见错误。 如果遇到的问题未在本文中列出，请在 GitHub 上提出问题。
完成无法正常工作
Azure CLI 的 Homebrew 公式将在 Homebrew 托管的完成目录中安装名为 az 的完成文件（默认位置为 /usr/local/etc/bash_completion.d/）。 若要启用完成功能，请按此处的 Homebrew 说明操作。
对于 Zsh，请将以下两行添加到 .zshrc 文件底部，然后保存并重新加载 Zsh 配置文件。
autoload bashcompinit && bashcompinit
source $(brew --prefix)/etc/bash_completion.d/az
找不到 Python 或已安装的软件包
在 homebrew 安装期间，可能存在次要版本不匹配或其他问题。 Azure CLI 不使用 Python 虚拟环境，因此它依赖于查找已安装的 Python 版本。 可行的解决方法之一是从 Homebrew 安装并重新链接 python@3.10 依赖项。
brew update && brew install python@3.10 && brew upgrade python@3.10
brew link --overwrite python@3.10
已安装 Azure CLI 版本 1.x
如果安装了过时的版本，则陈旧的 Homebrew 缓存可能导致此问题。 请遵照更新说明操作。
代理阻止连接
除非将其配置为使用代理，否则可能无法从 Homebrew 获取资源。 请遵循 Homebrew 代理配置说明。
重要
如果位于代理服务器的后面，必须设置 HTTP_PROXY 和 HTTPS_PROXY 才能使用 Azure CLI 连接 Azure 服务。 如果不使用基本身份验证，则应在 .bashrc 文件中导出这些变量。 请始终遵循企业的安全策略和系统管理员的要求。
若要从 Homebrew 获取瓶资源，代理需要允许与以下地址建立 HTTPS 连接：
https://formulae.brew.shhttps://homebrew.bintray.com
更新
Azure CLI 会定期更新 bug 修复、改进、新功能和预览功能。 新版本大约每月提供一次。
自版本 2.11.0 起，Azure CLI 提供了用于更新到最新版本的工具内命令。
az upgrade
默认情况下，此命令还将更新所有已安装的扩展。 有关更多 az upgrade 选项，请参阅命令参考页面。 对于 2.11.0 之前的 Azure CLI 版本，请按照安装 Azure CLI 中的说明重新安装以进行更新。
你还可更新本地 Homebrew 存储库信息，然后升级 azure-cli 包。
brew update && brew upgrade azure-cli
卸载
如果你决定卸载 Azure CLI，我们会遗憾地看到你离开。 在卸载之前，请使用 az feedback 命令告诉我们在哪些方面需要改进或修复。 我们的目标是消除 Azure CLI 中的 bug 并使其变得用户友好。 如果你在发现 bug 后提出 GitHub 问题，我们将十分感激。
使用 Homebrew 卸载 azure-cli 包。
brew uninstall azure-cli
删除数据
如果不打算重新安装 Azure CLI，请删除其数据。
rm -rf ~/.azure
其他安装方法
如果不能使用 homebrew 在你的环境中安装 Azure CLI，可以使用适用于 Linux 的手册说明。 此过程未得到官方维护以与 macOS 兼容。 建议使用包管理器（如 Homebrew）。 仅当没有其他选项可用时才使用手动安装方法。
有关手动安装说明，请参阅在 Linux 上手动安装 Azure CLI。
后续步骤
在 macOS 上安装 Azure CLI 后，请简要了解其功能和常见命令。
