vscode中args字段仅在f5调试时生效，必须配置为字符串数组如["--input", "data.txt"]，program须为纯路径；参数解析逻辑须置于if name == "__main__":块内，否则加载阶段即报错。
VSCode里给Python脚本传命令行参数，args字段只在F5调试时生效，右键“Run Python File”或Code Runner插件完全无视它——这是90%人第一次配就失败的根本原因。
launch.json里的args必须是字符串数组
常见错误是把参数拼成一个字符串，比如写成"--input data.txt"，这会让Python启动器报错找不到模块。正确写法是每个参数单独一项：
"args": ["--verbose", "--input", "data.txt", "-o", "output.json"]- 含空格的值直接用双引号包裹：
"--name", "Alice Smith"→sys.argv收到的就是['main.py', '--name', 'Alice Smith'] - 参数本身要带引号（比如JSON字符串），得双重转义：
"--config", "{\"port\":8080}" -
program字段必须是纯路径，不能塞参数："program": "main.py"✅，"program": "main.py --input data.txt"❌
F5调试才读args，其他运行方式全无效
VSCode的“运行”和“调试”走的是两套机制：
python全能编程助手
下载
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 按
F5或从“Run and Debug”面板选择配置 → 读args，进调试器，断点生效 - 右键 → “Run Python File in Terminal” → 执行
python main.py，不读args，也不进调试流程 - 安装了Code Runner插件？默认仍走
python main.py，除非你手动改它的code-runner.executorMap配置 - 想让“Debug Python File”按钮也带参，必须加
"purpose": ["debug-in-terminal"]，且配置名得是Python: Current File (Integrated Terminal)
参数没生效？先查代码入口逻辑
断点没命中的常见原因是：参数解析代码没放在if __name__ == "__main__":块里。
- 如果
main.py顶层就调了parse_args()或直接打开sys.argv[1]指定的文件，那调试器加载模块时就会立刻报错——此时args还没传进去 - 所有依赖参数的操作（读文件、连数据库、初始化配置）必须严格放在
if __name__ == "__main__":之后，或其调用的函数内部 - 调试时可在
parse_args()后加print(args)确认是否收到预期值，避免白忙活 -
cwd字段影响相对路径解析，建议显式设为"cwd": "${workspaceFolder}"
最易被忽略的一点：args不是全局开关，它只控制当前调试会话；换一个launch配置、换一个文件、甚至只是没选对下拉菜单里的配置项，参数就彻底失效。每次F5前，务必盯一眼左下角的调试配置名称。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
