通过

安装或更新 Azure 开发人员 CLI

欢迎使用 Azure 开发人员 CLI（azd）！ 让我们开始安装和了解如何运行 azd。

首先选择开发环境。 有关不同开发环境选择的优缺点的详细信息，请参阅 Azure 开发人员 CLI （azd） 支持的环境。

有关更高级的安装方案和说明，请参阅 Azure 开发人员 CLI 安装程序脚本。

注意：安装 azd 时，以下工具会在 azd 范围内安装（这意味着它们并未全局安装），并在卸载 azd 时被删除：

安装 azd

winget install microsoft.azd

更新 azd

winget upgrade microsoft.azd

卸载 azd

winget uninstall microsoft.azd

注释

在 Apple Silicon Mac（M1 和 M2） azd 上，需要罗塞塔 2。 如果尚未安装 Rosetta 2，请从终端运行 softwareupdate --install-rosetta。

安装 azd 过程将自动为计算机的体系结构选择正确的二进制文件。

安装 azd

brew tap azure/azd && brew install azd

只需运行一次 brew tap azure/azd 命令即可配置 brew 中的 tap。

如果要从brew未安装azd的版本升级brew，请删除使用卸载脚本的现有版本azd（如果安装到默认位置），或者手动删除azd二进制文件。 这会自动安装正确的版本。

更新 azd

brew upgrade azd

卸载 azd

brew uninstall azd

安装 azd

curl -fsSL https://aka.ms/install-azd.sh | bash

更新 azd

curl -fsSL https://aka.ms/install-azd.sh | bash

安装 azd时，以下工具安装在 azd 作用域内（这意味着它们未全局安装），并在卸载 azd 时将被移除：

卸载 azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

先决条件

在开始使用 azd之前，请确保具备：

在开发容器中安装azd

开发容器是一个 Docker 映像，其中包含在本地计算机上运行应用所需的所有先决条件。 通过以下步骤在开发容器中安装 azd 为功能：

  1. 将azd功能添加到模板根目录的.devcontainer文件夹的devcontainer.json文件。

    {
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        // See https://containers.dev/features for list of features
        "ghcr.io/devcontainers/features/docker-in-docker:2": {
        },
        "ghcr.io/azure/azure-dev/azd:latest": {}
    }
    // Rest of file omitted...
}

  2. 重新生成并运行开发容器。 在 Visual Studio Code 中，使用 命令面板 执行 "重新生成并在开发容器中重新打开" 命令。

验证安装

azd通过在终端中运行azd version命令来验证安装是否成功完成：

azd version

azd 打印当前版本：

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

更新 Azure 开发人员 CLI

使用过时版本 azd时，你将看到升级到最新版本的警告。 按照警告中的说明更新到最新版本。

请求帮助

有关如何提交 bug、请求帮助或为 Azure 开发人员 CLI 提出新功能的信息，请访问 故障排除和支持 页。

后续步骤

快速入门 - 选择并部署 azd 模板

什么是 Azure 开发人员 CLI 模板？

Azure Developer CLI 常见问题解答