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

在 macOS 上安装 Azure CLI

  • 项目

Azure 命令行接口 (CLI) 允许使用交互式命令行提示符或脚本通过终端执行命令。 可以在 macOS 计算机上本地安装 Azure CLI。 macOS 上的 Azure CLI 允许使用交互式命令行提示符或脚本通过终端执行各种命令。

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

Azure CLI 的当前版本为 2.59.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 入门