在Debian 系统安装 .NET 10 操作手册

适用场景：在 Debian 12 (Bookworm) 或 Debian 13 (Trixie) 上安装 .NET 10 SDK。
操作账户：本手册使用 root 用户执行命令。如果你使用的是普通用户，请在所有命令前加上 sudo。

确认系统架构（必须为 x64 或 Arm64）：
```
uname -m
```
- 输出 x86_64 或 aarch64 则符合要求。若为其他，请改用官方安装脚本。
切换至 root 用户（如果你当前是普通用户）：
```
su -
```

注意：此方案适用于通过系统包管理器 (APT) 安装，便于后续更新。如果此方案因网络或配置问题失败，请直接跳至备选方案。

清除旧配置（如果有）：

dpkg --purge packages-microsoft-prod
rm -f /etc/apt/sources.list.d/microsoft-prod.list

下载并安装微软源配置包（请根据你的系统版本选择一条执行）：

Debian 12 (Bookworm)：

wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
dpkg -i packages-microsoft-prod.deb

Debian 13 (Trixie)：

wget https://packages.microsoft.com/config/debian/13/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
dpkg -i packages-microsoft-prod.deb

更新 APT 包列表：
```
apt update
```
安装 .NET 10 SDK：
- SDK
```
apt install -y dotnet-sdk-10.0
```
- ASP.NET Core 运行时
```
apt install -y aspnetcore-runtime-10.0
```
- .NET 运行时：不包含 ASP.NET Core 支持，是最精简的运行时
```
apt install -y dotnet-runtime-10.0
```

当 APT 方式无法找到包时使用，此方法不依赖系统包管理器，兼容性更好。

下载并执行脚本：

wget https://dot.net/v1/dotnet-install.sh
chmod +x ./dotnet-install.sh
./dotnet-install.sh --channel 10.0

脚本会将 .NET 默认安装至 $HOME/.dotnet 目录。

配置环境变量（安装后必须执行，否则 dotnet 命令无法识别）：
```
echo 'export PATH="$HOME/.dotnet:$PATH"' >> ~/.bashrc
source ~/.bashrc
```

无论通过哪种方式安装，执行以下命令确认安装结果。

检查版本信息：
```
dotnet --version
```
预期输出：10.0.1xx 开头的版本号。
查看详细运行时信息：
```
dotnet --info
```
检查输出中是否包含 .NET SDK 10.0 及 ASP.NET Core 运行时。
创建并运行测试项目（终极验证）：
```
dotnet new console -n TestApp
cd TestApp
dotnet run
```
如输出 Hello, World!，则表明安装完全正确。

常见问题处理

Error: Unable to locate package：请尝试上方的备选方案（官方脚本）。
command not found：说明环境变量未正确设置。请参考备选方案步骤 2 添加 PATH，或使用 find / -name dotnet 找到安装路径后手动添加。
权限错误 (不在 sudoers)：请先用 su - 切换到 root 用户再执行全部命令。