你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 macOS 上安装 Azure CLI

项目
11/14/2024

Azure 命令行接口（CLI）是可在 macOS 计算机上本地安装的跨平台命令行工具。可以使用 Azure CLI 连接到 Azure，并使用交互式命令行提示或脚本在 Azure 资源上执行管理命令。

对于 macOS 平台，请使用 homebrew 包管理器安装 Azure CLI。使用 Homebrew 可以轻松保持 CLI 的最新安装状态。该 CLI 包已在 macOS 10.9 和更高版本中测试。

Azure CLI 的当前版本为 2.66.0。有关最新版本的信息，请参阅发行说明。若要查找已安装的版本并查看是否需要更新，请运行 az 版本。

使用 Homebrew 安装

Homebrew 是管理 CLI 安装的最容易的方法。它可以方便地进行安装、更新和卸载。如果系统中没有可用的 Homebrew，请先安装 Homebrew，然后继续。

在 macOS 上安装 Azure CLI 时，可以先更新 brew 存储库信息，然后运行 install 命令：

brew update && brew install azure-cli

疑难解答

如果在通过 Homebrew 安装 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 安装期间，可能会出现次要版本不匹配或其他问题。 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

已安装 CLI 安装 1.x

如果安装了过时的版本，则陈旧的 Homebrew 缓存可能导致此问题。请遵照更新说明操作。

代理阻止连接

你可能无法从 Homebrew 获取资源，除非已将其正确配置为使用你的代理。请遵循 Homebrew 代理配置说明。

重要

如果你位于代理后面，则必须设置 HTTP_PROXY 和 HTTPS_PROXY 以通过 CLI 连接到 Azure 服务。如果不使用基本身份验证，建议将这些变量导出到 .bashrc 文件中。请始终遵循企业的安全策略和系统管理员的要求。

为了从 Homebrew 获取 Bottle 资源，代理必须允许与以下地址之间的 HTTPS 连接：

https://formulae.brew.sh
https://homebrew.bintray.com

更新

CLI 定期使用 Bug 修复、改进、新功能和预览版功能进行更新。大约每 3 周发布一个新版本。

自版本 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，下面简要介绍其功能和常用命令。

Azure CLI 入门

通过