VSCode本地调试启动即中断主因是launch.json中request与调试协议不匹配:request为"launch"时自动加--inspect-brk(Node)或默认暂停(Python),属正常设计;若误用launch本意为attach,或program路径错误、cwd设错、console配置不当、request字段缺失/拼错,均会导致静默失败或无法调试。

VSCode本地调试启动即中断,绝大多数情况是 launch.json 里配了 "request": "launch" 但没让进程真正“可调试”,或者你本意想 attach 却误用了 launch 模式——不是代码问题,是调试协议没对上。
为什么一按F5就卡在第一行?
这是 --inspect-brk(Node)或 debugpy(Python)的默认行为:启动时立即暂停,等调试器连接。它本身不是故障,而是设计如此;但如果你没打算从头调试,这种“卡住”就显得突兀。
- Node.js 项目:只要
launch.json中"type": "node"+"request": "launch",VSCode 就会自动加--inspect-brk,无需手动写 - Python 项目:
debugpy默认也会在入口处暂停,除非你在launch.json显式加"justMyCode": true并确保断点设在你自己的模块里 - 如果只是想跳过启动暂停,把断点设在后续逻辑行(比如函数内部),然后按
F5继续即可;别删掉request: launch去硬改成attach,那会导致根本连不上
launch.json里哪些参数改了会直接导致“启动即中断失效”?
不是所有字段都安全可调;改错一个,VSCode 可能静默降级为普通运行(不调试),或直接报错退出。
-
"program"路径错误:指向不存在的文件、或指向.ts但没配ts-node,VSCode 启动后立刻崩溃,看起来像“没反应” -
"cwd"设错:Node 报Cannot find module、Python 找不到包,进程秒退,调试器来不及挂载 -
"console"设成"externalTerminal"后又关掉了终端窗口:某些平台(尤其是 Windows)下进程会被连带杀死,表现为“启动即消失” - 删掉
"request"字段或拼错成"requeest":VSCode 用默认配置 fallback,大概率走非调试模式执行,断点完全不生效
怎么确认你的调试真的连上了?
别只看有没有红点,关键看左下角状态栏和顶部调试工具栏是否“活”起来。
- 左下角必须显示类似
Debugging (Node.js)或Debugging (Python),而不是灰掉的Run and Debug - 顶部调试控制栏出现
F5/F10/F11按钮,且当前处于高亮激活态;如果按钮不可点,说明调试会话没真正建立 - 打开
Debug Console标签页:有输出Debugger attached.(Node)或debugpy version x.x.x(Python)才算成功握手 - 在
Variables面板里能看到args、env等上下文变量,而不是空面板
最常被忽略的是:你以为在调试,其实只是点了右上角绿色三角(Code Runner);那个根本不读 launch.json,也不启 debugpy 或 --inspect,纯终端执行。务必用 F5 或左侧运行面板里的 ▶️ 图标启动。


















