欢迎使用 Azure Developer 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 install azure/azd/azd
如果要从brew未安装azd的版本升级brew，请删除使用卸载脚本的现有版本azd（如果安装到默认位置），或者手动删除azd二进制文件。 这会自动安装正确的版本。
更新 azd
brew upgrade --cask azure/azd/azd
卸载 azd
brew uninstall azd
先决条件
在开始使用 azd之前，请确保具备：
- 安装：
- Docker Desktop （即将推出其他选项）。
- 远程容器 VS Code 扩展
- 具有活动订阅的Azure帐户。 免费创建一个。
在开发容器中安装azd
开发容器是一个 Docker 映像，其中包含在本地计算机上运行应用所需的所有先决条件。 通过以下步骤在开发容器中安装 azd 为功能：
将
azd功能添加到模板根目录的devcontainer.json文件夹的.devcontainer文件。{ "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... }重新生成并运行开发容器。 在Visual Studio Code中，使用 命令面板执行 在开发容器中重新生成和重新打开命令。
自动安装 azd 扩展插件
azd开发容器功能支持在extensions容器生成期间自动安装以逗号分隔的azd扩展列表的选项。 容器启动后，即可使用这种方式安装的扩展，减少手动安装，并启用 azd 命令以使用已安装所需的扩展运行。
若要自动安装扩展，请将 extensions 选项添加到 azd 文件中的功能条目 devcontainer.json ：
{
"name": "Azure Developer CLI",
"image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
"features": {
"ghcr.io/azure/azure-dev/azd:latest": {
"extensions": "my-ext-1,my-ext-2"
}
}
}
该值 extensions 是以逗号分隔的 azd 扩展名称列表。 安装发生在容器生成期间，因此扩展可以在容器启动时立即使用。 更改扩展列表后，使用 Visual Studio Code 中的 Rebuild and Reopen in Dev Container 命令使用更新的扩展重新生成容器。
验证安装
azd通过在终端中运行azd version命令来验证安装是否成功完成：
azd version
azd 打印当前版本：
azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)
更新Azure开发人员 CLI
可以使用内置azd命令（Beta）进行更新，也可以使用用于安装它的相同方法手动进行更新azd update。
使用 azd update （Beta）
该 azd update 命令会自动检测 azd 最初是如何安装的，并使用适当的更新方法。
| 安装方法 | 什么是azd update的功能 |
|---|---|
winget |
运行 winget upgrade Microsoft.Azd |
choco |
运行 choco upgrade azd |
| 安装脚本或 MSI 软件包（Windows） | 使用自动备份和还原运行install-azd.ps1 |
| 安装脚本 （Linux/macOS） | 运行 install-azd.sh |
| Homebrew | 运行 brew upgrade --cask azure/azd/azd |
.deb
/
.rpm 包 |
直接下载并替换二进制文件 |
运行以下命令以更新到最新的稳定版本：
azd update
注释
该 azd update 命令当前处于 Beta 版中。 在 功能版本控制与发布策略 页上阅读有关 alpha 和 beta 功能支持的详细信息。
切换更新通道
azd 支持两个更新通道： stable （默认值）和 daily。 基于脚本的安装和 Homebrew 支持通道切换。 如果通过azd、winget或choco安装，日常构建版本在这些包管理器中不可用，azd update将提供先通过脚本重新安装的指导。
切换到 daily 通道并更新：
azd update --channel daily
切换回 stable 通道：
azd update --channel stable
切换通道时，azd 会在继续操作之前提示确认。
使用包管理器或安装脚本
还可以使用上述安装部分中所示的同一包管理器或安装脚本命令随时手动更新。 过期时 azd ，会显示一条警告消息，其中包含安装方法适用的更新命令。
请求帮助
有关如何提交 bug、请求帮助或为 Azure 开发人员 CLI 提出新功能的信息，请访问 troubleshooting and support 页。