F5调试失败主因是项目输出类型非Exe或未设为启动项目；需确认输出类型为控制台/Windows应用、存在Main或顶级语句、且已设为启动项目，同时确保Debug配置下生成.pdb符号文件。
直接按 F5 就能启动调试，但前提是项目必须是可执行类型（比如 OutputType 为 Exe），且已正确设置为启动项目。否则会提示“无法启动调试”或“找不到可调试目标”。
确认项目是可运行的控制台/Windows应用
很多调试失败其实卡在第一步：项目根本不是可执行程序。类库（ClassLibrary）、测试项目（xUnit/NUnit）默认不能直接按 F5 启动。
- 右键解决方案资源管理器中的项目 → 选择“属性” → 查看“应用程序”页签下的
输出类型，必须是控制台应用程序或Windows 应用程序 - 如果项目没有
Main方法，.NET 6+ 允许顶级语句，但需确保代码文件（如Program.cs）里有可执行逻辑，而不是纯声明 - 多项目解决方案中，右键目标项目 → “设为启动项目”，否则
F5会尝试运行默认选中的那个（可能是类库）
断点没生效？检查生成配置和符号文件
断点显示为空心圆或提示“当前不会命中断点”，常见原因是调试器没加载到对应源码的符号（.pdb 文件）。
- 确保当前启动配置是
Debug（不是Release）：顶部工具栏下拉菜单必须显示Debug，且平台为Any CPU/x64等匹配项 -
Release模式默认禁用调试信息，即使打了断点也不会命中；可在项目属性 → “生成” → 勾选“生成调试信息”临时解决，但不推荐长期用Release调试 - 检查
bin\Debug\net10.0\（或对应框架目录）下是否存在GetStartedDebugging.pdb文件，缺失则说明编译未生成符号
调试时看不到变量值？注意作用域和优化干扰
鼠标悬停看不到变量、自动 窗口为空、监视 表达式报“未定义”——这些通常不是调试器坏了，而是变量已出作用域或被 JIT 优化掉了。
- 局部变量只在声明它的代码块内可见，比如
for循环里的i在循环外就不可查 -
Debug模式下，JIT 编译器仍可能内联简单方法或移除未使用的局部变量，导致“变量不可用”。可在项目属性 → “生成” → “高级” → 将调试信息设为portable或embedded，并关闭“优化代码”（勾选框默认是关的，但建议确认） - 异步方法（
async）中，await后续代码实际运行在线程池线程上，调用堆栈会断开，此时局部变量可能已被回收——这不是 bug，是async的执行模型决定的
想调试第三方库或 .NET 源码？得手动配符号服务器
默认情况下，你只能看到自己写的代码。想点进 List<t>.Add</t> 或 HttpClient.SendAsync 看源码，需要启用源码级调试支持。
- 工具 → 选项 → 调试 → 常规 → 勾选“启用 .NET Framework 源码调试”和“启用源码服务器支持”
- 调试 → 选项 → 符号 → 勾选“Microsoft 符号服务器”，路径会自动填入
https://msdl.microsoft.com/download/symbols - 首次加载符号可能很慢，且部分 .NET 组件（如
System.Private.CoreLib）的源码映射不完整，别指望所有内部方法都能逐行跟进
最常被忽略的是：调试器本身依赖正确的项目输出类型和符号生成，而不是代码写得够不够“标准”。哪怕一行 Console.WriteLine("hello")，如果项目类型设错了，F5 就只是静默失败。
