必须安装匹配系统架构和版本的.NET SDK并配置环境变量，否则dotnet命令无法识别、项目编译失败或运行时崩溃；需先执行lsb_release -a和uname -m确认麒麟版本与CPU架构，再按x86_64或aarch64选择包管理或手动安装方式，最后验证dotnet --list-sdks及dotnet run输出“Hello, World!”。
在银河麒麟操作系统上运行C#程序，必须先安装匹配系统架构和版本的.NET SDK，并正确配置环境变量，否则dotnet命令无法识别、项目编译失败或运行时崩溃。
确认系统信息与架构
打开终端，依次执行以下两条命令：
lsb_release -a → 查看具体发行版名称和版本号，例如“Kylin V10 SP1”；
uname -m → 判断CPU架构：x86_64表示Intel/AMD平台，aarch64表示飞腾/鲲鹏等ARM平台，【这一步不可跳过，选错SDK包会导致后续所有操作无效】。
安装.NET SDK（推荐包管理方式）
适用于银河麒麟V10 SP1及基于Ubuntu 20.04构建的桌面版：
wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb；
sudo dpkg -i packages-microsoft-prod.deb；
sudo apt-get update；
sudo apt-get install -y dotnet-sdk-6.0。
安装完成后执行dotnet --list-sdks验证输出是否包含6.0.x版本。若提示命令未找到，请先执行sudo apt-get install -y libgdiplus，该库对Avalonia等UI框架至关重要。
安装.NET SDK（ARM平台手动安装）
适用于aarch64架构设备（如搭载飞腾D2000的麒麟终端）：
第一步：创建SDK安装目录并进入
sudo mkdir -p /usr/share/dotnet && cd /usr/share/dotnet
第二步：下载并解压ARM64 SDK
curl -sSL https://download.visualstudio.microsoft.com/download/pr/33389348-a7d7-41ae-850f-ec46d3ca9612/36bad11f948b05a4fa9faac93c35e574/dotnet-sdk-6.0.302-linux-arm64.tar.gz | sudo tar zxfv -
第三步：建立全局软链接
sudo ln -s /usr/share/dotnet/dotnet /usr/bin/dotnet
注意：解压后文件夹内必须存在dotnet可执行文件，否则软链接会失效；执行sudo chmod +x /usr/share/dotnet/dotnet确保权限可执行。
配置多版本共存（VS Code插件专用路径）
当VS Code中C# Dev Kit插件要求.NET 10而你的项目使用.NET 8时，需隔离运行时：
方法一：安装两个SDK版本
将.NET 8 SDK解压至/root/tools/dotnet8/，.NET 10 SDK解压至/root/tools/dotnet10/；
方法二：配置VS Code识别路径
Ctrl+Shift+P → 输入Preferences: Open User Settings (JSON) → 在settings.json中添加：
"dotnetAcquisitionExtension.existingDotnetPath": [
{"extensionId": "ms-dotnettools.csharp", "path": "/root/tools/dotnet10/dotnet"},
{"extensionId": "ms-dotnettools.csdevkit", "path": "/root/tools/dotnet10/dotnet"}
]
保存后重启VS Code，插件左下角出现扫描进度即表示生效。
验证环境是否就绪
执行dotnet new console -o testapp → 创建测试项目；
cd testapp → 进入目录；
dotnet run → 若输出“Hello, World!”则环境配置成功。
