args字段仅在F5调试时生效，右键运行或Ctrl+F5完全忽略；必须为字符串数组，如["--input", "data.txt"]；含空格值整体写；参数解析逻辑须置于if name == "__main__":块内。
只有 F5 启动调试时，args 字段才生效；右键“Run Python File”或 Ctrl+F5 完全忽略它。
launch.json 的 args 字段必须是字符串数组
常见错误是写成 "args": "--input data.txt" 或 "args": ["--input data.txt"]——这会让程序收到一个参数，而不是两个。正确写法是每个参数单独一项：
-
"args": ["--input", "data.txt", "-v"]✅ - 含空格路径直接整体写：
"args": ["--config", "./configs/my config.yaml"]✅（VSCode 自动处理 shell 转义） - 参数本身含双引号（如 JSON 字符串），需反斜杠转义：
"args": ["--cfg", "{\"log\":true}"]✅ -
program必须是纯路径，不能拼参数："program": "${file}"✅，"program": "${file} --input data.txt"❌（启动失败）
断点不触发？大概率是参数解析逻辑没包在 if __name__ == "__main__": 里
调试器加载模块时，会先执行所有顶层语句。如果脚本一导入就调用 open(sys.argv[1]) 或 parser.parse_args()，此时 sys.argv 还只是 ["script.py"]，必然报 IndexError 或 FileNotFoundError。
- 所有依赖
sys.argv或argparse的逻辑，必须放在if __name__ == "__main__":块内，或其直接调用的函数中 - 避免在模块顶层读文件、连数据库、初始化配置——这些操作需要参数才能安全执行
- 调试时可在
parse_args()后加print(args)，确认是否真收到了你配的值
想让“Debug Python File”按钮（顶部绿色虫子）也带参，得手动配用途
这个按钮默认走硬编码配置，完全不读 args。要让它生效，必须在 launch.json 对应配置中显式声明：
- 设置
"purpose": ["debug-in-terminal"] - 配置名必须严格为
"Python: Current File (Integrated Terminal)"（大小写、括号、空格都不能错） - 同时设
"console": "integratedTerminal"，否则可能 fallback 到内部调试器，仍不传参 - 更稳妥的做法：统一从左侧“Run and Debug”面板下拉菜单选你配好的配置再点 ▶️
非调试场景下传参，只能手动敲命令或配 tasks.json
VSCode 的“Run Python File”本质就是执行 python main.py，不支持任何参数。没有例外，也没有隐藏开关。
- 按
Ctrl+`唤出集成终端，cd到脚本目录，然后手动执行：python main.py --input data.csv -o result.json - Windows 用户注意 PowerShell 对引号敏感，建议临时切 CMD，或用
cmd /c python main.py ... - 如果常用某组参数，可配
tasks.json定义任务，避免重复输入
最容易被忽略的一点：args 是传给你的脚本的，不是传给 Python 解释器的。想传 --unbuffered 给 Python，得写进 runtimeArgs；想传 --port 3000 给你的脚本，才写进 args。混用会导致参数错位或静默失效。
