VSCode中仅调试（F5）支持通过launch.json的args数组传参，格式必须为JSON字符串数组如["--port","3000"]，含空格路径或双引号需正确转义；“Debug Python File”按钮默认不读args，需配置"purpose":["debug-in-terminal"]；非调试场景需手动在集成终端执行命令或配置tasks.json；务必检查program路径和cwd设置，且参数依赖逻辑须置于if name == "__main__":块内。
VSCode 里“运行代码”本身不支持传参，只有“调试”（F5）才通过 launch.json 的 args 字段注入参数；想手动输参，必须切到集成终端自己敲命令。
launch.json 的 args 字段怎么写才有效
这是唯一能稳定让 F5 调试时带参的方式，但写错就完全失效。
-
args必须是 JSON 字符串数组，不能是空格拼接的字符串——"args": ["--port", "3000"]✅，"args": "--port 3000"❌ - 含空格的值（如路径）直接整个写进一个元素里：
"args": ["--input", "./data/my file.txt"]，VSCode 会自动处理转义，不用额外加引号 - 参数本身含双引号（比如 JSON 字符串），得用反斜杠转义：
"args": ["--config", "{\"log\":true}"] -
args只影响调试（F5），和右键“Run Python File”或 Code Runner 扩展完全无关
为什么点“Debug Python File”按钮没反应
这个按钮默认不读 launch.json 里的 args，它走的是内置快捷配置，参数硬编码为空。
- 要让它生效，必须在
launch.json中显式添加"purpose": ["debug-in-terminal"]，且配置名得是Python: Current File (Integrated Terminal) - 否则哪怕
args写对了，按这个按钮也等于白配 - 更稳妥的做法：统一用左侧“Run and Debug”面板，从下拉菜单选你配好的配置再点 ▶️
非调试场景下怎么手动输参数
VSCode 的“运行”本质就是执行一条 shell 命令，所以最直白的办法就是自己敲。
- 按
Ctrl+`唤出集成终端，cd到脚本所在目录 - 执行完整命令，例如：
python main.py --input data.csv -o result.json - 注意：这里遵循系统 shell 规则（PowerShell 对引号更敏感，Windows 用户建议临时切 CMD 或加
cmd /c包裹） - 如果常用某组参数，可配
tasks.json定义任务，避免重复输入
参数没生效？先盯住 program 和 cwd
VSCode 不校验 args 合法性，但若目标程序根本没起来，你会误以为参数丢了。
-
program必须是相对于${workspaceFolder}的有效路径，比如"./src/main.py"，不能是"main.py"（缺引号）或绝对路径（易跨环境失效） -
cwd强烈建议显式设为"${workspaceFolder}"，否则像open("config.json")这类相对路径操作会因工作目录不对而报错 - 断点卡在
if __name__ == "__main__":外？说明代码在参数解析前就执行了副作用逻辑（如直接读文件），参数根本没机会被读取
真正容易被忽略的是：args 是调试器启动后才注入的，所有依赖参数的初始化行为，必须严格落在 if __name__ == "__main__": 块内或其调用链下游。不然你改十遍 launch.json，程序都在加载阶段就崩了。
