VSCode中args仅在F5调试（request:"launch"）时生效，必须为字符串数组如["--input","data.txt"]，且参数解析逻辑须置于if name == "__main__":块内；右键运行、Code Runner及attach模式均忽略args。
VSCode 本身不运行你的程序，它只负责把参数传给调试器或终端——所以“配置启动参数”本质是告诉 launch.json 或 shell 如何启动目标进程，而不是改 VSCode 自身。
launch.json 的 args 必须是字符串数组，不是拼接字符串
常见错误是把参数写成 "--input data.txt" 这种单字符串，Python 或 Node.js 启动器会把它当一个整体参数解析，导致 sys.argv 错位、process.argv 长度异常，甚至直接报错退出。
- 正确写法：
"args": ["--verbose", "--input", "data.txt", "-o", "output.json"] - 含空格的值（如路径、人名）直接用双引号包裹：
"--name", "Alice Smith"→ Python 收到的就是['main.py', '--name', 'Alice Smith'] - 参数里带 JSON 字符串？得双重转义：
"--config", "{\"port\":8080}" -
program字段只能是文件路径，不能带参数："program": "main.py"✅，"program": "main.py --input data.txt"❌
F5 调试才读 args，右键“Run Python File”完全无视
这是最常配错的地方：VSCode 的“运行”和“调试”走两套完全独立的机制。
- 按
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__": 块里
断点没命中、脚本一加载就报错，大概率是因为 parse_args() 或 sys.argv[1] 访问写在了模块顶层。调试器加载模块时就会立刻执行，而此时 args 还没传进去。
- 所有依赖参数的操作（读文件、连数据库、初始化配置）必须严格放在
if __name__ == "__main__":块内，或其调用的函数内部 - 调试时可在入口处加
print(sys.argv)确认是否收到预期值 -
cwd字段影响相对路径解析，建议显式设为项目根目录，否则--input data.txt可能找不到文件 -
args不是全局开关，它只控制当前调试会话；换一个launch.json配置、换一个文件、甚至只是没选对下拉菜单里的配置项，参数就彻底失效
想复用 Shell 脚本参数？用 debugpy attach 更可靠
AI/ML 项目里一堆 train.sh、eval.sh，里面塞满了环境变量和长串参数——手动同步到 launch.json 不仅费时，还极易不同步。
- 改造脚本：在启动 Python 命令前加
python -m debugpy --listen 5678 --wait-for-client - VSCode 中配置一个极简的 attach 配置：
"type": "python"、"request": "attach"、"port": 5678 - 所有
PYTHONPATH、--model-path、--batch-size 32全部由 Shell 脚本原样提供，VSCode 只负责连接 - 适合多脚本、多环境、开源项目协作场景——调试环境和运行环境彻底一致
真正容易被忽略的不是怎么写 args，而是没意识到 VSCode 的“运行”和“调试”根本不是一回事；更隐蔽的是，很多人把参数解析逻辑写在模块顶层，结果调试器还没开始传参，脚本已经崩溃退出了。
