VSCode Python调试不触发断点,主因是"justMyCode": true(默认)导致非标准入口代码被过滤;应设为false临时排查,或规范入口(如if name == "__main__")并配"module"/"program";模块启动须用"module"+"args",多进程需显式启用debugpy。

VSCode Python调试不触发断点?检查launch.json里"justMyCode"是否关了
断点灰色、点击无效、F5后直接跑完——大概率是"justMyCode": true(默认值)把你的代码过滤掉了。它只调试用户代码,但如果你没用python -m方式启动、或入口不是标准if __name__ == "__main__"结构,VSCode就认不出“这是我的代码”。
- 临时解决:在
.vscode/launch.json的配置里加"justMyCode": false - 长期更稳:确保你的脚本有明确入口,比如
main.py里写if __name__ == "__main__": main(),再配"module": "main"或"program": "${file}" - 注意:
"justMyCode": false会让调试器进入site-packages甚至Python内置模块,卡顿明显,仅用于排查
用python -m http.server这类模块启动时,launch.json必须用"module"字段
直接运行python -m http.server 8000,本质是调用http.server模块的__main__.py。VSCode不支持在"program"里填"-m http.server"这种命令行写法——它会当成一个文件路径去找,报错File not found。
- 正确写法:
"module": "http.server",再通过"args"传参:"args": ["8000"] - 同理,调试
pytest、black、flask run等,都得走"module"+"args",不能塞进"program" - 别漏掉
"console": "integratedTerminal",否则http.server这类需要终端交互的模块会卡住不动
launch.json里"cwd"配错,会导致ImportError或找不到配置文件
VSCode默认以工作区根目录为当前路径启动调试器。但你的代码如果用from src.utils import helper,而src不在根目录下,或者读config.yaml时相对路径算错了,就会崩。
- 查清你代码实际期望的运行路径:比如项目结构是
myproject/src/main.py,且main.py里import的是utils,那"cwd"应该设为"${workspaceFolder}/src" - 别依赖
"program": "${file}"自动推导——它只改文件路径,不改工作目录 - 验证方法:在代码开头加
import os; print(os.getcwd()),对比终端里cd xxx && python xxx.py的真实路径
调试多进程/子进程时断点失效?subprocess和multiprocessing要分开处理
默认情况下,VSCode只附加到主Python进程,子进程(比如subprocess.Popen启的、multiprocessing.Process开的)完全不受控,断点自然不生效。
立即学习“Python免费学习笔记(深入)”;
-
subprocess:加"env": {"PYTHONPATH": "${workspaceFolder}"},并在子进程命令里显式调用python -m debugpy --listen 5678 --wait-for-client ...,再手动Attach -
multiprocessing:在if __name__ == "__main__":里加mp.set_start_method('spawn'),并确保所有进程都走debugpy启动,不能靠父进程继承 - 简单绕过法:临时把
multiprocessing.Process换成threading.Thread,线程共享调试上下文,断点照常生效(仅限验证逻辑,非生产)
调试器附加机制本身不跨进程,这点容易被忽略——你以为点了F5就全进了,其实只有最外层那个Python解释器在VSCode掌控中。


















