vscode报“sdk缺失”本质是dotnet命令未被识别，需先验证dotnet --version是否可用；若不可用则安装sdk并配置path，windows需重启vscode，macos/linux需手动添加路径至shell配置；若命令可用但omnisharp找不到sdk，则检查dotnet --list-sdks输出、omnisharp.path设为"auto"、launch.json中program指向正确.dll路径及targetframework匹配，并确认项目文件夹含.csproj后重启omnisharp。
VSCode 报“SDK 缺失”，不是 VSCode 本身坏了，而是 dotnet 命令根本没被系统或编辑器识别到——所有后续编译、调试、智能提示都会瘫痪。
dotnet --version 在终端里跑不通
这是最底层的信号。VSCode 的 C# 扩展（Omnisharp）完全依赖这个命令来定位 SDK。如果终端敲 dotnet --version 报 command not found 或直接无响应，说明 SDK 没装，或者装了但没进 $PATH。
- Windows 用户：装完 SDK 后务必重启 VSCode（不是重载窗口），否则 Omnisharp 不会重新扫描环境
- macOS/Linux 用户：检查
which dotnet是否返回路径；若为空，需手动把 SDK 的 bin 目录（如/usr/local/share/dotnet）加进~/.zshrc或~/.bashrc，再执行source ~/.zshrc - 别信“安装程序点下一步就完事了”——某些静默安装包（尤其企业镜像源）会跳过环境变量写入
Omnisharp 日志里反复出现 “Unable to locate the .NET SDK”
这说明 dotnet 命令能运行，但 Omnisharp 找不到 SDK 安装目录。常见于多版本共存、权限隔离或自定义安装路径场景。
- 运行
dotnet --list-sdks看输出是否为空或不全；若只显示部分版本，可能是当前 shell 权限无法读取某些 SDK 子目录 - 检查 VSCode 设置里的
omnisharp.path，必须设为"auto"；设成绝对路径容易失效，尤其跨 SDK 版本升级后 - 在 macOS 上用 Homebrew 装的 SDK，有时会被装进非标准路径（如
/opt/homebrew/share/dotnet），需确认该路径下存在sdk/子目录且有子版本文件夹（如sdk/8.0.400/）
launch.json 里 program 指向 .cs 文件却报“找不到可执行程序”
这不是 SDK 缺失，但常被误判为 SDK 问题。C# 是编译型语言，launch.json 的 program 字段必须指向编译后的 .dll，不是源码。
- 错误写法：
"program": "${workspaceFolder}/Program.cs"→ 必然失败，VSCode 会报Cannot launch program; setting 'program' must be an absolute path to the executable - 正确写法：
"program": "${workspaceFolder}/bin/Debug/net8.0/${fileBasenameNoExtension}.dll"，注意其中net8.0必须和项目.csproj中的<targetframework></targetframework>完全一致 - 如果项目是
net6.0却硬写net8.0，Omnisharp 日志里会出现Unable to find dll at .../net8.0/...—— 这其实是路径错配，不是 SDK 没装
状态栏右下角没出现 .NET 图标（带版本号）
这是 VSCode 内部是否成功加载 SDK 的最终指示器。即使 dotnet --version 和 dotnet --list-sdks 都正常，这里没图标，说明 Omnisharp 没完成初始化。
- 先确认你打开的是整个项目文件夹（含
.csproj），不是单个.cs文件 —— 否则 Omnisharp 根本不启动项目上下文 - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入 “Omnisharp: Restart OmniSharp”，强制重载 - 如果重启后仍无图标，看输出面板中 “OmniSharp Log” 是否有
Starting OmniSharp server之后的卡顿或超时，大概率是 SDK 路径权限或版本兼容问题（比如装了 .NET 9 SDK，但 C# 扩展旧版不支持）
真正卡住人的，往往不是“没装 SDK”，而是“装了但路径不可见”“版本不匹配”“VSCode 没刷新上下文”。每次改完环境变量或 SDK，都要关掉所有终端和 VSCode 实例再重开，别省那几秒钟。
