最直接且唯一可靠的方式是在 launch.json 的调试配置中设置 stopOnEntry 为 true;它需置于 configurations 数组内,配合正确的 type(如 "node"、"python")和路径、sourceMaps 等参数才生效。

launch.json 里设 stopOnEntry 为 true
这是最直接、也唯一可靠的方式。VSCode 调试器在启动时是否停在入口(比如 Node.js 的 index.js 第一行,或 Python 的 if __name__ == "__main__" 处),完全取决于这个配置项。
-
stopOnEntry默认是false,所以不设就永远不会自动中断 - 必须放在
.vscode/launch.json的某个调试配置(configurations数组中的一项)里,不能放在顶层 - 它和语言无关,但需配合正确的
type(如"node"、"python"、"chrome")才能生效
Node.js 项目示例:入口中断 + 确保 source map 可用
如果你用的是 TypeScript 或带构建流程的 JS 项目,光设 stopOnEntry: true 可能还是停不住——因为调试器找不到原始入口文件。
- 确认
program指向的是编译后产物(如./dist/index.js),而不是./src/index.ts - 同时必须开启
sourceMaps: true,否则断点会“漂移”,stopOnEntry也失去意义 - 若用
ts-node直接运行 TS,type应为"pwa-node",且需加"runtimeArgs": ["-r", "ts-node/register"]
Python 项目要注意 justMyCode 干扰
Python 调试器默认启用 justMyCode: true,这会导致 stopOnEntry 停在 Python 解释器启动处,而不是你的脚本第一行。
- 显式设
"justMyCode": false可让中断落到你自己的代码入口,但副作用是也会停进标准库内部(一般不需要) - 更稳妥的做法是:保持
justMyCode: true,但把断点手动打在你主模块的第一条可执行语句上(比如def main():或第一个print()) - 如果用
python -m http.server这类命令行启动方式,stopOnEntry不适用,得改用console或preLaunchTask配合
为什么有时设了 stopOnEntry: true 却没反应
这不是配置写错了,而是调试器根本没加载到你的 launch 配置,或者路径根本没对上。
- 检查左下角状态栏是否显示当前选中的调试环境(如 “Python”、“Node.js”),没选对就等于没读配置
- 确认
launch.json在项目根目录的.vscode/下,且文件名全小写、无空格或隐藏字符 - Node.js 项目若用了
npm start启动,stopOnEntry不会生效——它只对直接执行 JS 文件有效;要用runtimeExecutable指向node并传参 - 修改
launch.json后必须重启调试会话(Shift + F5再F5),热重载不生效
launch.json 路径和 program 字段,比反复改 stopOnEntry 有用得多。


















