launch.json的args字段仅在f5调试时生效，右键运行或code runner不读取；args必须为字符串数组，参数含空格不需额外引号，且解析逻辑须置于if name == "__main__":块内。
launch.json里args字段只在F5调试时生效
右键“Run Python File”或Code Runner插件完全不读args，这是90%人配错的根源。F5启动调试器才会加载launch.json里的参数；其他方式都是直接执行python main.py，和args无关。
常见误操作包括：
- 把参数拼进
program字段，比如写成"program": "main.py --input data.txt"→ 启动失败，报ModuleNotFoundError或找不到模块 - 用字符串而非数组写
args，如"args": "--verbose --input data.txt"→ Python解释器把整个字符串当做一个参数，sys.argv长度异常，argparse解析失败 - 没选对调试配置：左下角调试配置下拉菜单里显示的是当前激活的配置名，换文件、切分支、甚至只是没点一下下拉框，都可能让它默认回退到“Python: Current File”，而你改的是另一个配置
args必须是字符串数组，且空格值要单独成项
args字段必须严格为JSON数组，每个参数占一项。含空格的值（如人名、路径）不用额外加引号包裹——JSON解析器会自动保留空格，Python收到的就是原样字符串。
示例正确写法：
["--name", "Alice Smith", "--config", "dev.yaml"]
对应sys.argv为：['main.py', '--name', 'Alice Smith', '--config', 'dev.yaml']
如果参数本身要带双引号（比如内嵌JSON），需双重转义：
["--config", "{\"port\":8080,\"host\":\"localhost\"}"]
此时sys.argv[2]就是{"port":8080,"host":"localhost"}，可直接json.loads()解析。
Windows用户注意：PowerShell对引号处理更敏感，建议在launch.json中显式指定"console": "integratedTerminal"并确保终端类型设为Command Prompt（可通过设置terminal.integrated.defaultProfile.windows控制）。
参数解析逻辑必须放在if __name__ == "__main__":块内
调试器先加载模块，再执行入口代码。如果main.py顶层就调用argparse.ArgumentParser().parse_args()，或直接访问sys.argv[1]打开文件，那它会在args传入前就崩溃——典型错误是FileNotFoundError，但launch.json明明写了"args": ["--input", "data.txt"]。
必须确保：
- 所有依赖参数的操作（读文件、连数据库、初始化模型）都在
if __name__ == "__main__":之后 - 或封装进函数，只在该块内调用，例如
main(parse_args()) - 调试时可在
parse_args()后加print(args)确认是否收到预期值，避免白忙活
否则断点根本命不中——因为出错发生在模块导入阶段，调试器还没走到你的断点行。
想让非调试方式也带参？得绕过args走终端命令
launch.json的args是调试专属机制。若希望右键“Run Python File”或Code Runner也能传参，唯一可靠方式是手动切到集成终端（Ctrl + `），然后敲完整命令：
python main.py --input test.csv -o result.json
或者配置tasks.json定义一个shell任务：
{
"version": "2.0.0",
"tasks": [
{
"label": "run-with-args",
"type": "shell",
"command": "python main.py --input data.txt -v",
"group": "build"
}
]
}
然后按Ctrl + Shift + P → Tasks: Run Task选择它。这种方式不依赖调试器，参数由shell解析，行为与终端一致，但无法进断点。
最容易被忽略的一点：args不是全局开关，它只绑定当前launch.json配置项；同一项目里多个配置、不同文件、甚至没注意左下角那个小小的配置名称，都会导致参数静默失效。每次F5前，务必盯一眼那里显示的是不是你要的那个配置。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
