VSCode C#调试断点不中断、异常不捕获的根本原因是调试上下文未建立：JIT未禁用内联、符号未加载或栈帧未标记为可调试；需确保Debug配置、portable PDB、MethodImpl(NoInlining)、COMPLUS_JITMinOpts=0及justMyCode=false等协同生效。
VSCode 调试 C# 时断点不中断、异常不捕获，根本不是配置写错了，而是调试上下文没建立起来——Debugger.Break() 失效、try/catch 里抛出的异常跳过断点、甚至 F5 按下后直接运行完退出，全因 .NET 运行时没把当前栈帧标记为“可调试”，或调试器压根没加载符号。
为什么 Debugger.Break() 在 VSCode 里完全没反应
这不是 VSCode 的 bug，是 JIT 编译器和调试协议协同失效的结果。当你在反射调用、DynamicMethod 或 AOT 编译路径中调用 Debugger.Break()，它可能被内联掉，或跳过调试器注入点。
-
Debugger.Break()依赖运行时处于“调试器已附加 + 符号可用 + JIT 未优化”三重状态，缺一不可 - 确保项目使用
Debug配置编译，且.csproj中有<debugtype>portable</debugtype> - 在目标方法上加
[MethodImpl(MethodImplOptions.NoInlining)]，尤其对被反射调用的方法 - 启动前执行
set COMPLUS_JITMinOpts=0（Windows）或export COMPLUS_JITMinOpts=0（macOS/Linux），禁用 JIT 内联优化 - 避免用
Delegate.CreateDelegate()替代MethodInfo.Invoke()，前者绕过调试器可识别的调用栈
异常抛出时断点不命中，但控制台却打印了堆栈
这是典型“异常未被用户代码捕获”现象：VSCode 默认只在“用户未处理异常”（即未被 try/catch 捕获）时中断；一旦你写了 catch，它就默认“已处理”，跳过断点。
- 打开调试面板 → 点击齿轮图标 → 在
launch.json中添加："justMyCode": false，让调试器也进入框架/库代码 - 按
Ctrl+Shift+P（Win）或Cmd+Shift+P（Mac），输入Debug: Toggle Exception Breakpoint，勾选Common Language Runtime Exceptions下的Thrown（而非仅Uncaught） - 若异常来自异步任务（如
Task.Run(() => throw new Exception())），需额外启用"enableStepOver": true并确认Task未被await前就抛出 - 检查
.csproj是否含<optimize>true</optimize>—— Release 模式下异常堆栈可能被裁剪，导致断点无法准确定位
launch.json 配置中 program 字段总为空或路径错乱
这不是手写配置的问题，而是 VSCode 根本没识别到项目结构。它不会从单个 Program.cs 推导出输出路径，必须靠 .csproj 或 .sln 文件驱动自动解析。
- 务必用
File > Open Folder打开包含.csproj的文件夹，而不是直接打开.cs文件 - 首次按
F5时弹出 “Required assets missing…” 提示，一定要选Yes，否则launch.json不会填入真实program路径 -
program值应类似"${workspaceFolder}/bin/Debug/net8.0/MyApp.dll"（注意是.dll，不是.exe；.NET 6+ 控制台项目默认输出 DLL） - 若手动改过
TargetFramework（如从net8.0改成net9.0），必须重新运行dotnet build，否则bin/下无对应目录
Unity 项目里断点灰色、始终不命中
Unity 的 C# 调试是独立生态，和标准 .NET SDK 完全隔离。VSCode 显示 C# (LSP) 或 <no project></no>，说明它正在尝试用 dotnet 加载 UnityEngine，这注定失败。
- Unity 编辑器中必须点击
Assets → Open C# Project，生成Assembly-CSharp.csproj；仅勾选Generate .csproj files设置不够 - VSCode 右下角状态栏必须显示
C# (Unity)，不是C# (LSP)；若不是，删掉.vscode/和obj/，重启 VSCode 后再打开文件夹 - Unity 编辑器右下角虫子图标必须是
Debug Mode（蓝色），不是Release Mode（灰色）；且需先点一次播放按钮让进程就绪 -
launch.json必须用type: "vstuc"（Unity Debugger）而非"coreclr"，且不能设program字段——Unity 调试是 attach 模式，不是 launch
最常被忽略的一点：所有这些配置都依赖 .pdb 文件与程序集同目录且未被剥离。哪怕 launch.json 写得再准，只要 MyApp.dll 旁边没有 MyApp.pdb，断点就只是红色圆点，不会变实心。
