为什么VSCode的C#扩展无法找到dotnet，dotnet --list-sdks返回空行？

dotnet --list-sdks输出空行是核心问题，优先解决该问题后VSCode扩展报错会同步修复，以下是对应排查步骤：

1. 多架构SDK路径优先级冲突（最高发原因） #

Windows系统中如果同时安装了x86和x64版本的dotnet SDK，PATH中优先级更高的架构会优先被读取，另一架构的SDK会被屏蔽：

• 分别打开C:\Program Files\dotnet（x64默认路径）和C:\Program Files (x86)\dotnet（x86默认路径），查看两个文件夹下是否存在sdk子目录，确认你已安装的SDK对应的架构
• 打开系统环境变量配置界面，找到PATH变量，将你需要使用的dotnet架构对应路径，移动到另一架构dotnet路径的上方，保存配置
• 重启所有已打开的命令行窗口、VSCode，重新执行dotnet --list-sdks验证

2. SDK安装不完整/残留冲突 #

安装时权限不足或者旧版本残留会导致SDK识别异常：

• 从控制面板卸载所有带dotnet标识的程序
• 手动删除C:\Program Files\dotnet和C:\Program Files (x86)\dotnet两个目录下的所有残留文件
• 下载对应架构的dotnet SDK安装包，右键选择「以管理员身份运行」完成安装
• 重启电脑后重新执行dotnet --list-sdks验证

3. global.json配置限制 #

如果当前用户目录或者项目目录下存在global.json配置文件，会强制限定可识别的SDK版本：

• 检查C:\Users\你的用户名目录、当前打开的C#项目根目录下是否存在global.json文件
• 若存在该文件，打开查看其指定的SDK版本号，要么安装对应版本的SDK，要么删除该global.json文件即可解除限制

VSCode扩展适配 #

待dotnet --list-sdks可以正常输出版本后，如果C#扩展仍报错，手动指定dotnet路径即可：

• 打开VSCode设置，搜索dotnet path，找到「Dotnet Path」配置项
• 手动填入你确认可用的dotnet.exe完整路径，示例：C:\Program Files\dotnet\dotnet.exe
• 重启VSCode后配置生效

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