断点不命中主因是调试配置与运行方式不匹配：request类型错配（launch/attach混淆）、debugpy未正确安装、.net未用debug配置编译、前端缺失source map或webroot路径错误，以及断点设在不可执行行。
VSCode断点调试本身不难，难在「断点打了但不命中」「程序启动了但进不了调试器」「变量全显示为undefined」——这些问题90%以上不是VSCode的问题，而是调试配置与项目实际运行方式不匹配。
为什么断点打了却没反应？检查 launch.json 的 request 类型
VSCode 调试行为完全由 launch.json 中的 request 字段决定。常见错误是把应该用 "request": "attach" 的场景写成了 "request": "launch"，或者反过来。
-
"request": "launch"：适用于你控制整个进程生命周期的场景，比如直接运行一个 Python 脚本、启动一个 .NET 控制台应用、或用npm start启动前端开发服务器（需配合runtimeExecutable） -
"request": "attach"：适用于进程已存在、你只是“附着”上去调试的情况，比如调试 Docker 容器里的服务、调试正在运行的 Windows 服务、或 Apollo 模块这类通过buildtool启动后长期驻留的进程 - 误用后果：用
launch去连一个已运行的进程，VSCode 会尝试新建一个进程并失败；用attach去启动一个新脚本，会卡在“等待连接”状态，永远不开始
Python 调试必须装 debugpy，且版本要和 VSCode 匹配
VSCode 的 Python 扩展默认不自带调试器，它依赖外部的 debugpy。这不是可选项，是硬性前提。
- 安装命令必须是：
python -m pip install --upgrade debugpy，不能只装pip install debugpy，否则可能装到错误的 Python 环境里 - 如果你用的是 conda 环境，得先
conda activate myenv再执行上面那条命令 - VSCode 1.85+ 对
debugpy版本有要求：太旧（如 1.6.x）不支持 Python 3.12，太新（如 2.2+）可能和某些旧版 Python 扩展不兼容；推荐固定用debugpy==2.1.1 - 验证是否生效：在终端运行
python -m debugpy --help，有输出即说明安装成功且路径正确
C# / .NET 项目必须用 Debug 配置编译，且符号文件（PDB）得在 bin/Debug 下
.NET 项目的调试能力几乎完全取决于编译产物是否包含完整调试信息。Release 模式下，dotnet build 默认会剥离 PDB 文件、启用优化，导致断点失效、变量无法查看。
- 确认当前构建配置：
dotnet build -c Debug或在.csproj中显式指定<configuration>Debug</configuration> - 检查输出目录：
bin/Debug/net8.0/MyApp.dll旁边必须有同名的.pdb文件（如MyApp.pdb），缺一不可 - 如果用的是 Visual Studio 生成的
.sln，确保 VSCode 任务调用的是MSBuild的Debug配置，而不是默认的Release；可在tasks.json的args中加/p:Configuration=Debug - Windows 上若用 MSVC 工具链编译 C++，对应的是
/Zi编译参数和/DEBUG链接参数，缺一不可
前端调试（Vue/React）别只靠浏览器，要打通 source map
现代前端框架打包后代码和源码完全不同，断点打在压缩后的 app.js 上毫无意义。真正起作用的是 source map 文件（.js.map），它建立了打包后代码和原始 .vue 或 .tsx 的映射关系。
- Vue CLI 或 Vite 默认开启 source map，但生产环境（
mode: 'production'）会关闭；调试时务必确认vite.config.ts或vue.config.js中build.sourcemap设为true - Chrome DevTools 能自动加载本地 source map，但 VSCode 的
Debugger for Chrome插件需要你在launch.json中明确配置sourceMaps: true和webRoot（指向你本地源码根目录，不是打包后的dist） - 常见坑：
webRoot写成"${workspaceFolder}/dist"就永远找不到源码；正确写法是"${workspaceFolder}"，让调试器根据 source map 自动定位 - 如果用 Volar（Vue 3 推荐），还需在
settings.json中启用"volar.trace.server": "messages"查看语言服务是否正常解析.vue单文件组件
最常被忽略的一点：断点是否落在可执行语句上。比如在空行、注释行、import 行、或 TypeScript 的类型声明行打的断点，VSCode 会自动忽略——它不会报错，也不会提示，只是安静地不触发。动手前，先确认光标停在真实运行的代码上。
