launch.json 的 args 字段需为字符串数组，每个参数单独一项，且所有参数解析逻辑必须置于 if name == "__main__": 块内；配置 "purpose": ["debug-in-terminal"] 和 "console": "integratedTerminal" 可使“Debug Python File”按钮支持参数。
launch.json 的 args 字段怎么写才有效
只有在 F5 启动调试时，args 字段才起作用；右键“Run Python File”或 Ctrl+F5 运行完全忽略它。常见错误是把参数拼进 program 路径里，比如写成 "program": "main.py --input data.txt"——这会导致启动失败，因为 program 必须是纯路径（如 "${file}" 或 "${workspaceFolder}/src/main.py"）。
args 是字符串数组，每个参数单独一项：
- 正确：
["--input", "data.txt", "-v"] - 含空格的值直接写，JSON 自动处理：
["--name", "Alice Smith"]→ Python 收到sys.argv中就是'Alice Smith' - 参数本身要带引号（比如 JSON 字符串），需双重转义：
["--config", "{\"port\":8080}"] - 不要写成
["--input data.txt"]—— 这会被当做一个参数，不是两个
为什么断点没生效，或者程序一启动就报错
典型现象：launch.json 明明配了 args，但 F5 一按就 FileNotFoundError: data.txt。原因往往是代码在 if __name__ == "__main__": 外就执行了依赖参数的操作，比如模块顶层就调用了 open(sys.argv[1]) 或 parser.parse_args()。
调试器加载模块时，会先执行所有顶层语句，此时 args 还没传给进程，sys.argv 仍是默认值（只有脚本名）。所以：
- 所有参数解析逻辑（
argparse.ArgumentParser().parse_args()）必须放在if __name__ == "__main__":块内，或其直接调用的函数中 - 避免在 import 阶段读文件、连接数据库、初始化配置等需要参数才能进行的操作
- 调试时可在
parse_args()后加一句print(args)，确认是否真收到了预期值
想让“Debug Python File”按钮也带参，怎么配
VSCode 默认的“Debug Python File”按钮（顶部绿色虫子图标）不读 args，除非你显式配置它使用集成终端并标记用途。需要两步：
- 在
launch.json对应配置里加上"purpose": ["debug-in-terminal"] - 确保该配置的
name是"Python: Current File (Integrated Terminal)"（名字必须完全匹配，大小写和括号都不能错） - 同时设置
"console": "integratedTerminal"，否则可能 fallback 到内部调试器，仍不生效
这样点按钮或按 Ctrl+F5 就能走终端调试路径，args 才会生效。
非调试场景下怎么输参数
VSCode 的“Run Python File”（右键菜单）本质就是执行 python main.py，不支持传参。真要手动输，得切到集成终端自己敲：
python main.py --input test.csv -o result.json
注意：这是 shell 命令，遵守 shell 解析规则（比如 PowerShell 对引号更敏感），和 launch.json 互不影响。如果你代码用 argparse 或 sys.argv，两种方式拿到的参数结构一致。Windows 用户若遇到引号问题，可临时切到 Command Prompt，或用 cmd /c python main.py ... 包裹。
参数解析逻辑的位置、args 数组的拆分粒度、以及调试入口的执行时机——这三个地方出错，基本覆盖了 90% 的带参调试失败原因。别在模块顶层做任何有副作用的事，哪怕只是一行 print() 依赖未解析的 sys.argv，都可能让调试器卡在加载阶段。
