Ubuntu 22.04下.NET无法识别已安装SDK问题求助

问题背景 #

近期开发C#脚本时，运行dotnet命令出现报错：

zaphod@eddie:~$ dotnet list-sdks
You must install or update .NET to run this application.

App: /usr/share/dotnet/sdk/7.0.302/dotnet.dll
Architecture: x64
Framework: 'Microsoft.NETCore.App', version '7.0.5' (x64)
.NET location: /usr/share/dotnet/

No frameworks were found.

错误显示dotnet已安装，但SDK 7.0.302依赖的Microsoft.NETCore.App 7.0.5框架缺失。尝试彻底删除.NET相关文件重装后，出现新错误：

The command could not be loaded, possibly because:
  * You intended to execute a .NET application:
      The application 'list-sdks' does not exist.
  * You intended to execute a .NET SDK command:
      No .NET SDKs were found.

已确认PATH变量包含/usr/bin、/usr/share/dotnet、/usr/share/dotnet/sdks，排除PATH配置问题。

修复步骤 #

1. 彻底清理残留.NET文件 #

执行命令删除所有.NET相关文件与配置：

sudo apt remove --purge dotnet* aspnetcore*
sudo rm -rf /usr/share/dotnet/
sudo rm -rf /etc/dotnet/
sudo rm -rf ~/.dotnet/
sudo rm -rf ~/.nuget/

2. 添加官方软件源 #

确保系统能获取到微软官方的.NET安装包：

wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

3. 安装指定版本.NET SDK #

更新软件包索引后，安装目标版本的SDK（以7.0为例）：

sudo apt update
sudo apt install dotnet-sdk-7.0

4. 验证安装结果 #

运行以下命令确认SDK与运行时状态正常：

dotnet --version
dotnet list-sdks
dotnet list-runtimes

额外说明 #

若需安装多版本.NET，直接安装对应版本SDK即可，系统会自动处理依赖的运行时。若问题仍存在，检查是否有第三方软件源冲突，可暂时禁用非官方源后重试安装。

内容的提问来源于stack exchange，提问作者Carbon_Based