安装
更新: 2026-10-16 15:20:09 字数: 0 字 时长: 0 分钟
Aspire 提供了一个命令行界面（CLI）工具，帮助您创建和管理基于 Aspire 的应用程序。该 CLI 以交互式体验为核心，简化开发流程。
请选择适合您环境的包管理器——Homebrew、npm、NuGet、WinGet、mise 或 Nix——也可以使用安装脚本直接安装。
使用 VS Code？
Aspire VS Code 扩展可以替您安装 CLI。在命令面板中执行：
Aspire: Install Aspire CLI (stable)安装前请先完成环境准备。
使用包管理器安装
brew install --cask microsoft/aspire/aspirenpm install -g @microsoft/aspire-clidotnet tool install -g Aspire.Cliwinget install Microsoft.Aspiremise use -g aspirenix run github:microsoft/aspire#aspire-cli各方式的注意事项：
| 方式 | 说明 |
|---|---|
| Homebrew | 适用于 macOS（Apple Silicon 与 Intel）。 |
| npm | 需要 Node.js。同一命令在 Windows / macOS / Linux 通用（含 Alpine 等 musl 发行版）；npm 会自动选择匹配当前系统与架构的原生二进制。 |
| NuGet | 需要 .NET SDK。包名为 Aspire.Cli，以 .NET 全局工具形式发布。 |
| WinGet | 适用于 Windows x64 与 Arm64。 |
| mise | 适合统一管理开发工具版本。 |
| Nix | 需要 Nix 2.4 以上并启用 flakes。也可以加入 profile：nix profile add github:microsoft/aspire#aspire-cli。 |
在 flake.nix 中引用
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/";
aspire.url = "github:microsoft/aspire";
aspire.inputs.nixpkgs.follows = "nixpkgs";
};
outputs =
{ nixpkgs, aspire, ... }:
let
systems = [ "aarch64-darwin" "aarch64-linux" "x86_64-darwin" "x86_64-linux" ];
forAllSystems = nixpkgs.lib.genAttrs systems;
in
{
devShells = forAllSystems (
system:
let
pkgs = nixpkgs.legacyPackages.${system};
in
{
default = pkgs.mkShell {
packages = [ aspire.packages.${system}.aspire-cli ];
};
}
);
};
}Nix 下的版本固定
CLI 版本由 aspire flake 输入的 revision 与该提交上的 eng/nix/versions.json 决定。要固定到特定版本，请把 aspire 输入锁定到某个 Git revision。
使用安装脚本
curl -sSL https://aspire.dev/install.sh | bashcurl -sSL https://aspire.dev/install.sh | bashirm https://aspire.dev/install.ps1 | iex脚本会安装 Aspire CLI 的最新稳定版。安装过程中可能询问 Do you want to continue?，回复 Y（是）或 A（全部是）继续。
需要先审阅脚本？
可以先把脚本下载下来单独检查再执行。安装命令也可以随时从官网顶部导航的下载入口重新获取。
验证安装
aspire --version输出形如：
13.4.0+{commitSHA}+{commitSHA} 后缀表示该 CLI 是从哪个提交构建的。
再执行一次环境自检：
aspire doctor它会检查证书状态、容器运行时、CLI 版本等常见问题。
更新
更新 CLI 自身
aspire update --self如果要通过 npm 或 .NET 工具安装，该命令会打印出对应的包管理器命令让您执行（例如 npm install -g @microsoft/aspire-cli@latest），而不是替换由包管理器管理的二进制。Nix 安装同理。
npm 用户也可以直接：
npm install -g @microsoft/aspire-cli@latest更新项目中的 Aspire 版本
aspire update该命令会自动：
- 检测过时的 Aspire 集成、模板与 SDK 版本。
- 按当前配置的发布渠道更新 SDK 版本与 Aspire 集成版本。
- 处理在代码中、
aspire.config.json中或支持的集中式版本文件中声明的版本。
详见升级 Aspire。
卸载
brew uninstall --cask aspirenpm uninstall -g @microsoft/aspire-clidotnet tool uninstall -g Aspire.Cliwinget uninstall Microsoft.Aspiremise uninstall aspire一并清理缓存
CLI 的缓存与日志位于 ~/.aspire，卸载后可以按需删除。
