dotnet --list-sdks输出为空或版本不匹配说明vscode/omnisharp未识别目标sdk，需先验证终端命令输出是否含项目所需版本（如8.0.400），再检查系统安装、path配置及权限；windows需重装sdk并重启vscode，macos需确认homebrew安装路径有效性，linux需补全依赖库；同时确保omnisharp.path设为"auto"且.csproj中与launch.json中框架名严格一致。
dotnet --list-sdks 输出为空或版本不对
这说明 VSCode 或 OmniSharp 根本没看到你想要的 SDK 版本——不是 launch.json 写错了，是底层环境没对齐。
先在终端里运行 dotnet --list-sdks，看输出是否包含项目所需的版本（比如 8.0.400 [/usr/share/dotnet/sdk]）。如果空着、只显示旧版本，或显示路径权限被拒（如 Permission denied），就别急着改配置。
- Windows 用户：重装带 “SDK” 字样的安装包（不是 Runtime），装完必须重启 VSCode（不是重载窗口）
- macOS 用户：Homebrew 安装后执行
xcode-select --install；若用手动解压方式，确认/usr/local/share/dotnet/sdk/8.0.400/这类路径真实存在且可读 - Linux 用户：检查是否缺
libicu72或libssl3，Ubuntu/Debian 下补装命令是sudo apt install libicu72 libssl3
launch.json 中 program 找不到 .dll 文件
报错信息通常是 Cannot launch program; setting 'program' must be an absolute path to the executable，本质是框架版本不匹配，不是路径写错了。
program 字段必须指向 bin/Debug/net8.0/YourApp.dll 这类编译产物，而 net8.0 必须和项目 .csproj 里的 <targetframework>net8.0</targetframework> 完全一致。哪怕差一个点（比如写成 net8.0.1）也会失败。
- 不要硬编码框架名，用变量：
"${workspaceFolder}/bin/Debug/net8.0/${fileBasenameNoExtension}.dll" - 如果项目是
net6.0，就得把net8.0换成net6.0，否则 Omnisharp 日志里会提示Unable to find dll at ... - 确保已执行过
dotnet build，bin/Debug/目录下真有对应框架子目录和 .dll 文件
OmniSharp 日志报 “Unable to locate the .NET SDK”
这时 dotnet --version 能跑通，但 OmniSharp 启动时找不到 SDK 安装根目录，常见于多版本共存或自定义路径场景。
VSCode 设置里 omnisharp.path 必须设为 "auto"，设成绝对路径反而容易失效——尤其升级 SDK 后，旧路径就断了。
- 打开 VSCode 设置（Ctrl+,），搜索
omnisharp.path，确认值是"auto"（不是字符串"auto"，是 JSON 值） - 检查 OmniSharp Log（Ctrl+Shift+U → 选 “C#”），看是否有类似
Failed to resolve SDK directory的行 - 如果日志里出现
Could not resolve SDK directory，别改 launch.json，先解决这个——它比调试配置优先级高得多
打开单个 .cs 文件就调试失败
状态栏右下角没有 .NET 图标、不显示 SDK 版本、F5 点下去直接报错，大概率是因为没以文件夹方式打开项目。
OmniSharp 只在含 .csproj 或 .sln 的目录下激活。打开单个 Program.cs，它连项目依赖和 TargetFramework 都不知道，更别说找 DLL 了。
- 正确做法：用
dotnet new console -n MyApp创建项目，然后 VSCode 选 File > Open Folder，打开MyApp文件夹 - 错误做法：双击
MyApp/Program.cs直接打开——这时工作区无上下文，所有调试配置都无效 - 打开后看状态栏右下角是否出现 OmniSharp Server: Running 和 .NET 版本号，没有就说明项目结构没被识别
<targetframework></targetframework> 这两处是否真正对得上——中间差一个字符，整个调试链就断了。
