歡迎來到 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 需要 Rosetta 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 中，使用 command palette執行 Rebuild 並重新開啟 Dev Container 指令。
自動安裝azd 擴充功能
azd Dev 容器特性支援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 中使用
了解更多關於 azd 開發容器功能。
確認安裝
在終端機中執行命令azd，以驗證您的azd version安裝已成功完成：
azd version
azd 列印目前版本：
azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)
更新 Azure 開發人員 CLI
你可以用內建指令（Beta）更新 azd ，或是用安裝時相同的手動方式更新 azd update 。
使用 azd update 測試版
指令 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。 頻道切換支援腳本安裝及自製軟體。 如果你是透過 azd 或 winget 安裝 choco 的話，這些套件管理器無法提供每日構建 — azd update 會顯示先使用腳本重新安裝的指引。
為了切換到 daily 頻道並更新，請依照以下步驟操作：
azd update --channel daily
要切換回到stable 頻道：
azd update --channel stable
切換頻道時， azd 會提示確認後再繼續。
使用你的套件管理器或安裝腳本
你也可以隨時使用與安裝區段相同的套件管理器或安裝腳本指令手動更新。 當 過期時 azd ，會顯示警告訊息，並依照你的安裝方法執行相應的更新指令。
請求幫助
如需了解如何提出錯誤、請求協助或建議Azure開發者 CLI 新功能，請造訪 troubleshooting and support 頁面。