VSCode调试成败关键在于断点命中、变量可视、流程可控，而非单纯设断点；根本原因常是launch.json配置错误、环境不匹配或调试器未启用。
VSCode 调试 Python/JavaScript/Node.js 代码，核心不是“怎么打断点”，而是“断点能不能命中、变量能不能看清、流程能不能控住”——绝大多数调试失败，问题出在 launch.json 配置错、运行环境不匹配、或没启用正确的调试器。
为什么打了断点却根本不暂停？
这是最常被忽略的第一步：VSCode 本身不执行代码，它只是前端界面，真正干活的是背后的调试器（如 python 的 debugpy、node 的内置 inspector）。断点不生效，通常因为：
- 没装对应语言的官方调试扩展（比如 Python 必须装
ms-python.python，JavaScript/TypeScript 要确保已启用内置的Node Debug） -
launch.json中的type写错了："type": "python"不能写成"type": "Python"（大小写敏感）；"type": "node"不能用于纯浏览器 JS - 运行方式不对：点了右上角绿色三角（Run Code），而不是左侧调试图标里的 ▶️（Start Debugging）——前者是直接执行，不走调试协议
- 代码实际运行路径和
launch.json里配置的program或file不一致（比如你调试src/main.py，但配置里写的是./main.py，而当前工作目录不在src下）
launch.json 中最关键的三个配置项
不必背全，但以下三项必须核对清楚，否则 90% 的断点失效都源于它们：
-
program（Python）或file（Node.js）：必须是**绝对路径或相对于cwd的正确相对路径**。建议用${workspaceFolder}变量，比如"program": "${workspaceFolder}/src/app.py" -
cwd（current working directory）：影响模块导入、文件读写路径。Python 报ModuleNotFoundError、Node 报Cannot find module，八成是这里设错了 -
env和envFile：调试时环境变量默认不继承终端，需要显式传入。比如 Django 项目必须设"DJANGO_SETTINGS_MODULE"，否则启动就报错
示例（Python）：
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Current File",
"type": "python",
"request": "launch",
"module": "django.core.management",
"args": ["runserver"],
"cwd": "${workspaceFolder}/backend",
"env": {
"DJANGO_SETTINGS_MODULE": "myproject.settings.dev"
}
}
]
}
调试 JavaScript 时，Chrome 和 Node.js 的断点行为完全不同
很多人把两者混用，结果发现断点在 Chrome 里能停，在 Node 里不停，或反过来。关键区别在于：
- Chrome 调试（
type: "pwa-chrome"）：调试的是**浏览器中运行的前端代码**，断点只能打在.js或经构建后生成的源码映射（source map）上；console.log输出在浏览器控制台，不是 VSCode 的 Debug Console - Node.js 调试（
type: "node"）：调试的是本地node进程，断点打在原始.js或.ts文件上；console.log默认输出到 VSCode 的 Debug Console，且支持debugger语句触发断点 - TypeScript 项目必须配
sourceMaps: true，且确保构建产物里有.map文件，否则 Chrome 调试时断点会“跳偏”到编译后代码行
变量看不清、作用域混乱？试试这两个操作
不是所有变量都能在“Variables”面板里立刻看到，尤其涉及闭包、异步回调、或经过 Babel/TS 编译后的变量名：
- 在“Watch”面板手动添加表达式，比如输入
JSON.stringify(state)或Object.keys(this)，比依赖自动展开更可靠 - 右键变量 → “Copy Value” 或 “Copy as Expression”，粘贴到 Debug Console 直接求值，适合快速验证复杂对象结构
- 遇到
undefined却不确定是真未定义还是没加载出来？在 Debug Console 输入typeof xxx，比只看值更准
真正难的从来不是加断点，而是理解当前栈帧里哪些变量可见、哪些被优化掉了、哪些还在 Promise 微任务队列里没执行——这些没法靠界面按钮解决，得结合代码逻辑和调试器状态一起判断。
