很多人在 VSCode 里调试 C# 控制台程序时，一点 F5 就报错。 问题通常不在 launch.json，而在底层环境没对上。

最常见的情况是：终端里 dotnet --list-sdks 的输出，和项目文件里写的框架版本不一致。中间哪怕只差一个字符，整个调试链就会断掉。

先看 SDK 版本是否对齐

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。

重点检查 .dll 路径和框架版本

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 里的 net8.0 完全一致。哪怕差一个点，比如写成 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 能否正确识别 SDK

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 版本号，没有就说明项目结构没被识别。

结论

实际最容易卡住人的，往往不是 launch.json 怎么写。

真正要先核对的是 dotnet --list-sdks 的输出，以及 .csproj 里 是否完全对得上。

中间只要差一个字符，整个调试链就会断掉。