安装

更新: 2026-06-29 16:39:57   字数: 0 字   时长: 0 分钟

Aspire 提供了一个命令行界面（CLI）工具，帮助您创建和管理基于 Aspire 的应用程序。该 CLI 通过以交互式体验为核心，简化了您的开发流程。本指南将指导您如何在系统上安装 Aspire CLI。您可以选择适合您环境的包管理器——Homebrew、npm、NuGet、WinGet 或 mise——或使用安装脚本进行直接设置。

安装 Aspire CLI

• 包管理器安装

Homebrew

brew install --cask microsoft/aspire/aspire

npm

npm install -g @microsoft/aspire-cli

NuGet

dotnet tool install -g Aspire.Cli

WinGet

winget install Microsoft.Aspire

mise

mise use -g aspire

• 脚本安装

Bash

curl -sSL https://aspire.dev/install.sh | bash

PowerShell

irm https://aspire.dev/install.ps1 | iex

• 验证

要验证 Aspire CLI 是否已安装，请使用 aspire --version 查询 Aspire CLI 的版本号：

aspire --version

如果该命令有效，您将看到 Aspire CLI 工具的版本：

13.4.0+{commitSHA}

The +{commitSHA} 后缀表示 Aspire CLI 是从哪个特定提交构建的。

更新 Aspire CLI

aspire update --self

如果你通过 npm 或 .NET 工具安装了 CLI，aspire update --self 会打印出对应的包管理器命令来运行（例如 npm install -g @microsoft/aspire-cli@latest），而不是替换由包管理器自带的二进制文件。

更新 Aspire 应用版本

aspire update

此命令会自动：

• 检测过时的 Aspire 集成、模板和 SDK 版本
• 为已配置的 Aspire 渠道更新 SDK 版本和 Aspire 集成版本
• 处理在代码中、 aspire.config.json 中或支持的集中式版本文件中声明的版本