launch.json 的 args 字段必须手动配置为字符串数组,F5调试才传参;“Debug Python File”默认不读args,需设"purpose": ["debug-in-terminal"];多进程子进程需显式监听debugpy端口或改用fork方式。

launch.json 的 args 字段必须手动配置,点“Debug Python File”按钮无效
VSCode 不会从任意地方自动读取命令行参数。你写的 --config config.yaml --workers 4,只有明确写进 launch.json 的 args 数组里,F5 启动时才会传进去。
常见错误是:在终端里能跑通 python run.py --config config.yaml,但 F5 调试时程序报错说找不到 config 文件——因为调试器根本没收到那个参数。
-
args必须是字符串数组,每个参数单独一项:["--config", "config.yaml", "--workers", "4"],不能写成["--config config.yaml"] - 配置必须放在
configurations数组的某一条里,且该条要被 F5 选中(看左上角调试面板下拉菜单) - “Debug Python File”右键菜单或顶部绿色三角按钮默认不读
args;想让它生效,得加"purpose": ["debug-in-terminal"]并把配置名设为Python: Current File (Integrated Terminal) - 如果项目有多个 Python 文件,确保
program指向的是你真正想调试的入口,比如"program": "${workspaceFolder}/run.py",而不是留空或用${file}(后者只对当前打开文件有效)
多进程场景下,args 传进去了,但子进程断点不触发
args 只控制主进程启动参数,不影响子进程是否被调试器接管。multiprocessing 创建的每个子进程都是独立解释器,默认完全脱离 debugpy 连接。
你看到的现象是:主流程断点正常,print 输出也稳定;但 ProcessPoolExecutor 里的函数里打的断点完全不响,日志偶尔刷一下就消失——这不是参数问题,是调试器没 attach 上去。
- 方案一(推荐):用
spawn启动方式 +debugpy.listen()显式监听。在子进程入口函数开头加import debugpy; debugpy.listen(5678); debugpy.wait_for_client(),再在 launch.json 里配好端口转发或附加配置 - 方案二:改用
fork方式(仅 Linux/macOS),子进程会继承父进程的 debugpy 连接,断点可直接命中,但要注意 fork 后的资源状态一致性问题 - Windows 默认只能用
spawn,所以方案一几乎是必选项;不要指望加个"justMyCode": false就能让子进程断点自动生效
调试带参数的多线程代码,断点总停在主线程
threading 创建的线程共享同一个 Python 解释器和 debugpy 实例,所以断点本身是能进的,但 VSCode 默认只高亮当前活动线程,其他线程的断点看起来像“失效”了。
你改完代码加了 ThreadPoolExecutor,断点打在 worker 函数里,运行后光标一直停在 executor.submit(...) 那行,worker 里断点纹丝不动——其实是线程切换太快,调试器没及时聚焦过去。
- 在 VSCode 调试面板底部,点击“THREADS”标签,能看到所有活跃线程列表;点击任一线程可切换上下文,断点就会在对应线程里触发
- 避免在
time.sleep()或阻塞 IO 前打断点,容易错过线程调度时机;优先在计算逻辑入口处设断点 - 如果用了
concurrent.futures.as_completed(),注意它返回的是生成器,实际执行可能延迟到 for 循环才发生,断点要打在循环体内部
launch.json 配置写对了,但参数还是没生效
最常被忽略的是工作目录(cwd)和路径解析问题。VSCode 不会自动把相对路径映射到你预期的位置。
比如你在 args 里写了 ["--input", "data/input.csv"],但脚本报错说文件不存在——不是参数没传,而是它在找 ${workspaceFolder}/data/input.csv,而你实际把文件放在了 ./scripts/data/input.csv。
- 显式设置
"cwd": "${workspaceFolder}/scripts",让所有相对路径以此为基准 - 路径含空格或中文?全部用双引号包裹,如
"--config", "./my project/config.yaml" - 不要依赖波浪线
~,VSCode 不展开它;用绝对路径或${env:HOME}(Linux/macOS)或${env:USERPROFILE}(Windows)替代 - 检查
python.defaultInterpreterPath是否指向你期望的 Python 环境;虚拟环境路径写错会导致模块导入失败,掩盖参数问题


















