当前（2026年5月）应在统信UOS上安装.NET 8 LTS版本，因其支持x86_64/aarch64/loongarch64全架构、具备AOT编译能力且无API兼容性与安全风险；需先执行uname -m确认架构，再安装libunwind8、libssl3、libicu72等依赖，最后通过微软APT源或龙芯镜像站安装SDK，并正确配置DOTNET_ROOT与PATH环境变量。
在统信UOS上安装最新版.NET Core，是为了让C#项目能直接在国产操作系统中编译、调试和发布，避免因版本陈旧导致的API不兼容、安全漏洞或LTS支持终止问题。当前（2026年5月）.NET 8是微软官方长期支持（LTS）的最新稳定版本，其性能、AOT编译能力与ARM/LoongArch架构适配度远超3.1或5.0。
确认系统架构与基础依赖
打开终端，执行：uname -m → 查看输出结果：若为x86_64、aarch64或loongarch64，说明架构明确；若为mips64el等小众型号，需转向龙芯社区或统信应用商店查找定制包。
运行以下命令安装必要运行时依赖：sudo apt update && sudo apt install -y curl wget libunwind8 libssl3 libicu72。注意：统信UOS 20 SP1及以后版本已默认包含libssl3，但旧SP版本仍可能缺省libssl1.1——此时必须手动降级或替换，否则dotnet命令会报“SSL routines”错误。
这一步不可跳过。缺少libicu72会导致中文字符串处理异常、区域格式化失败，且错误提示极不直观，容易误判为代码问题。
下载并安装.NET 8 SDK（推荐包管理器方式）
方法一：使用微软官方APT源（适用于x86_64/aarch64）
依次执行：curl -sSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft-prod.gpgecho "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/microsoft-prod.gpg] https://packages.microsoft.com/repos/microsoft-debian-$(lsb_release -sc)-prod $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/microsoft.listsudo apt update && sudo apt install -y dotnet-sdk-8.0
方法二：龙芯平台专用安装（loongarch64）
访问龙芯开源社区镜像站（https://mirrors.loongnix.org/dotnet/），下载形如dotnet-sdk-8.0.100-linux-loongarch64.tar.gz的压缩包 → 解压到/opt/dotnet → 执行sudo ln -sf /opt/dotnet/dotnet /usr/bin/dotnet。这一步必须用ln -sf而非复制，否则升级时路径断裂。
【关键前提】执行前确保/opt/dotnet目录为空或已备份旧SDK，混放不同架构的dotnet二进制会导致dotnet --info输出混乱，且无法通过dotnet --list-sdks正确识别。
配置全局环境变量与验证安装
第一步：编辑用户级配置文件 → 运行nano ~/.bashrc（或~/.zshrc，取决于你默认shell）
第二步：在文件末尾新增两行：export DOTNET_ROOT=/opt/dotnetexport PATH=$DOTNET_ROOT:$PATH
第三步：保存退出后执行source ~/.bashrc使配置生效。
验证是否成功：dotnet --version应输出类似8.0.100的版本号；dotnet --list-sdks需显示完整路径与版本；dotnet new console -o hello && cd hello && dotnet run必须打印出“Hello, World!”。
如果dotnet run报错“MSBuild failed with exit code 1”，大概率是DOTNET_ROOT指向了空目录或权限不足——检查/opt/dotnet是否存在且当前用户有读取权限。
