VSCode调试Python时args字段需配置为字符串数组，如["--input", "data.txt"]，不可拼入program路径；参数仅在F5调试时生效，且必须在if name == "__main__":块内解析才有效。
launch.json 里怎么配 args 字段
VSCode 调试 Python 时，参数不是写在终端命令里的，而是通过 .vscode/launch.json 的 args 数组传给程序。这个字段只在调试（F5）时生效，运行（Ctrl+F5 或终端执行）不会读它。
常见错误是把参数直接塞进 program 路径后面，比如写成 "program": "main.py --input data.txt" —— 这会导致启动失败，因为 program 必须是纯文件路径。
-
args是字符串数组，每个参数单独一项：["--input", "data.txt", "-v"] - 含空格的值要用引号包裹（JSON 规则），但引号本身不传给 Python：
["--name", "Alice Smith"]→sys.argv收到的是['main.py', '--name', 'Alice Smith'] - 如果参数本身要带引号（比如 JSON 字符串），需双重转义：
["--config", "{\"port\":8080}"]
运行（非调试）时怎么输参数
VSCode 的「运行 Python 文件」（右键 → Run Python File in Terminal）默认不支持传参，它只是执行 python main.py。想手动输参数，得切到集成终端自己敲命令。
更省事的做法是：用 VSCode 终端，cd 到项目目录，然后运行完整命令：
立即学习“Python免费学习笔记（深入）”；
python main.py --input test.csv -o result.json
注意：这里用的是系统 shell 的命令行解析规则，和 launch.json 互不影响。如果你改了代码逻辑依赖 argparse 或 sys.argv，两种方式拿到的参数结构是一致的。
- 别在「Python: Run All Tests」这类任务里硬塞参数——它不认
args - 如果常用某组参数，可以配置一个
tasks.json任务，用shell类型调用python并带参 - Windows 用户注意：PowerShell 对引号处理更严格，建议临时切到 Command Prompt 或加
cmd /c包裹
为什么断点没命中断在 if __name__ == "__main__" 之前
调试器启动时会先加载模块，再执行入口代码。如果你在 import 阶段就写了有副作用的语句（比如直接调函数、读文件），而这些语句又依赖你传的参数，那它们会在 args 生效前就报错。
典型表现是：launch.json 明明配了 args，但一按 F5 就提示 FileNotFoundError: data.txt —— 因为代码在 if __name__ == "__main__": 外就尝试打开 data.txt 了。
- 所有参数解析逻辑（
argparse.ArgumentParser().parse_args()）必须放在if __name__ == "__main__":块内或其调用链下游 - 避免在模块顶层做任何需要参数才能进行的操作
- 调试时可以在
parse_args()后加个print(args)确认是否收到预期值
Python 扩展没装或配置错导致 args 不生效
VSCode 的 Python 调试能力完全依赖官方 Python 扩展（ms-python.python）。如果它没启用、版本太旧，或者工作区指定了错误的解释器，launch.json 里的 args 可能被忽略，甚至调试直接 fallback 到无参模式。
检查步骤：
- 确认已安装并启用 Python 扩展（ID 是
ms-python.python） - 按
Ctrl+Shift+P输入Python: Select Interpreter，选对带所需包的环境（比如venv或 conda） - 确保
launch.json的configurations中type是"python"，不是"pwa-node"或其他 - 如果用 Poetry 或 PDM，可能需要额外配
module字段而不是program，否则参数不透传
参数传递这事看着简单，但实际卡在路径、作用域、扩展状态任何一个环节，都会让你以为是 args 不起作用——其实它根本没机会被读到。
