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开的）完全不受控，断点自然不生效。
-
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掌控中。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
