VSCode断点不生效主因是调试环境与代码路径未对齐：Node.js需sourceMap配置正确并验证加载；Python需用module而非program、启用subProcess；前端需禁用压缩、配准webRoot和sourceMapPathOverrides；条件断点慎用函数调用且须重启调试会话。
VSCode 里断点不生效，90% 不是操作错了，而是调试环境和代码执行路径没对齐。直接开干。
Node.js 调试时断点停在 .js 而不是 .ts 文件？
这是 source map 映射失败的典型表现：你在 src/index.ts 打了断点，结果停在 dist/index.js 的压缩行上，变量名变成 _a、_b，甚至行号错位。
-
tsconfig.json必须含"sourceMap": true，且"outDir"指向实际构建目录（如dist） -
launch.json中要显式启用映射："sourceMaps": true，并用"outFiles"指向编译产物，例如"${workspaceFolder}/dist/**/*.js" - 多包项目（如
packages/foo/src）需加"resolveSourceMapLocations"，否则 VSCode 根本找不到该映射回哪个src/ - 验证是否生效：打开 Debug Console，搜
Loaded source map from，看到无 404 的路径才算真正加载成功
Python 调试时断点完全不触发？
不是脚本没运行，而是 VSCode 没按你预期的方式启动它——比如你点了 F5，但调试器实际执行的是 python script.py，而你的入口其实是 python -m mypackage.cli。
- 别用
"program"指向脚本文件；改用"module"字段，例如"module": "mypackage.cli" - 确认
python.defaultInterpreterPath指向项目虚拟环境里的解释器（如./venv/bin/python），不是系统 Python - 若用了
torch.utils.data.DataLoader(num_workers > 0)，主进程能断住，子进程默认不继承调试上下文——必须在launch.json配置中加"subProcess": true - 检查右下角状态栏是否显示「Python」和当前解释器路径，不是「Plain Text」或「Python (unavailable)」
前端 JS 断点在 Chrome 里灰了或跳到 bundle.js？
VSCode 本身不跑浏览器，它靠 Debugger for Chrome/Edge 扩展连接 DevTools 协议。断点失效，基本是连接上了但源码没对齐。
- 禁用构建压缩：
vite.config.ts中设build.minify = false；Webpack 关掉TerserPlugin -
launch.json的"type"推荐用"pwa-chrome"（非旧版"chrome"），"url"必须是真实可访问地址（http://localhost:5173），不能是file:// -
"webRoot"必须指向源码根目录，且"sourceMapPathOverrides"要匹配构建工具生成的路径。Vite 默认是"webpack:///./src/*"，就得写成"webpack:///./src/*": "${webRoot}/src/*" - 别依赖
debugger语句：它只在 DevTools 开着且上下文被接管时才生效；断点更稳定
条件断点一设就卡死或值不对？
条件断点不是简单写个表达式就行，它在每次命中时都会求值，而作用域、副作用、异步时机都可能翻车。
- 右键断点 → «Edit Breakpoint» 输入表达式，例如
i === 42或user.id > 1000；注意用严格相等，且变量必须在该行**执行前已声明并赋值** - 禁止在条件里调用函数（如
api.fetch()、localStorage.getItem()），可能引发超时、状态污染或直接跳过 - 高频循环中慎用：每轮都求值，性能敏感路径建议换日志点（Logpoint），格式如
user.name + " | " + user.age，不中断只输出 - 异步回调里设条件断点，注意
this或参数可能尚未初始化（尤其箭头函数第一行），可先单步步入再设
最易被忽略的点：修改 launch.json 或编译配置后，必须重启整个调试会话，热重载不生效；断点是否实心、状态栏是否显示「调试」、Debug Console 是否有 source map 加载日志——这三个信号缺一不可。
