Note
dotnetup 为公共预览版。 在正式发布之前，其功能和行为可能会更改。
dotnetup是用于用户级.NET安装的跨平台工具链管理器。 它安装.NET SDK 和运行时，而无需写入系统管理的.NET目录。 它还会跟踪所选的安装选项，以便以后更新或删除相关文件。
使用 dotnetup 来：
- 安装稳定版、预览版、每日构建版或指定的 .NET 版本。
- 在一个统一管理的安装中包含多个 SDK 和运行时要求。
- 安装最接近的
global.json文件所需的 SDK。 - 在不更改确切版本要求的情况下更新受跟踪的通道。
- 配置终端和应用程序如何查找托管
dotnet。 - 在不更改
PATH的情况下运行托管dotnet。 - 更新 dotnetup 可执行文件和控制更新通知。
Start
运行交互式设置：
> dotnetup init
Welcome to dotnetup!
SDK Channel: latest
Mode: Terminal Mode (Suggested)
Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
Setup complete!
安装程序要求选择要安装的 SDK 通道以及你希望如何访问受管理的 dotnet 命令。
为了实现简洁且非交互式的设置，请安装 SDK 并配置当前 Shell：
> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
> dotnetup env set shell
dotnet and dotnetup are on your PATH.
To apply the change to this terminal now, run:
<shell-specific command>
Or open a new terminal.
> dotnetup list
Installations (managed by dotnetup):
<default-installation-root>
Tracked channels:
SDK latest (source: explicit)
Installed versions:
SDK <resolved-version> (<architecture>)
Total: 1
> dotnet --version
<resolved-version>
如果不想更改 shell 配置文件，请使用转发命令：
> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
> dotnetup env set none
dotnetup is on your PATH. dotnet is not — run it with 'dotnetup dotnet <command>'.
Open a new terminal for the change to take effect.
> dotnetup dotnet --version
<resolved-version>
模式、解析后的版本、体系结构、安装路径和 shell 命令取决于系统和可用版本。
dotnetup 如何管理.NET
dotnetup 跟踪你请求安装的 SDK。 此跟踪允许 dotnetup 同时更新多个安装。 它还允许 dotnetup 安全地删除未使用或已停止支持的安装。
有关详细信息，请参阅 dotnetup 的工作原理。
选择下一步要阅读的内容
| 目标 | 文章 |
|---|---|
| 确定 dotnetup 是否适合你的方案 | 何时使用 dotnetup |
| 安装 dotnetup 并进行首次设置 | dotnetup 入门 |
| 了解通道、安装根目录和追踪 | dotnetup 的工作原理 |
使用存储库的 global.json |
管理存储库 SDK 要求 |
| 安装 SDK 和运行时 | 安装.NET组件 |
| 更新或移除安装 | 更新安装 |
| 更新或删除 dotnetup 本身 | 更新或删除 dotnetup |
配置 PATH 和 DOTNET_ROOT |
管理 dotnetup 环境 |
| 尝试预览版或每日构建版 | 使用预览版和每日版本 |
| 修复常见问题 | dotnetup 疑难解答 |
| 了解 dotnetup 收集哪些数据 | dotnetup 遥测 |
| 查找命令语法 | dotnetup 命令参考 |
Availability
dotnetup 以公共预览版的形式提供。 命令、选项和行为可能会在各预览版本之间发生变化，并且正式发布版的支持生命周期尚未最终确定。
若要安装 dotnetup，请参阅 dotnetup 入门。
安装后，运行 dotnetup --version 以确认版本并 dotnetup --help 查看可用命令。
