VS Code调试传参完全指南：launch.json配置实战

用VS Code调试程序，十个人里有七八个会卡在同一个地方：程序写好了，代码逻辑没问题，但需要从命令行接收参数才能跑起来。在终端里手动输入命令谁都会，可一旦按F5进调试器，参数怎么传进去就抓瞎了。我见过太多人因为这个把参数硬编码进代码里，测试完再改回来，来回折腾还容易漏改。

这篇东西就把VS Code里添加命令行参数这件事彻底讲透。覆盖Python、C/C++、Node.js几种主流语言，从最简单的launch.json配置讲起，到带空格的路径、环境变量、交互输入、多个参数方案快速切换，最后再聊聊什么时候该用调试器、什么时候直接在终端里跑。新手照着抄就能用，老手也能看看有没有自己忽略的细节。

1. 先把路数理清楚：VS Code里有几条路可以传参数

VS Code不是IDE，本质是个编辑器加调试前端的组合体。所以"添加命令行参数"这个需求，在你的工作流里至少有三种完全不同的场景，对应的解决办法也完全不一样。先把这三条路分清楚，后面才不会绕晕。

第一条路是调试场景。你按F5或者点击顶部菜单"运行"里的"启动调试"，此时VS Code会读取.vscode/launch.json文件，根据里面的配置启动调试器，再由调试器拉起你的程序。这个场景下，命令行参数的入口就是launch.json里的args字段。这是本文的核心，九成以上的人问的都是这个。

第二条路是普通运行场景。你打开VS Code内置的终端，手动敲python main.py --input data.txt或者./myapp arg1 arg2，然后在终端里看程序输出。这种情况根本不需要什么配置，跟你在任何命令行环境里操作一模一样。很多人困惑的是：为什么我改了launch.json，在终端里运行却没效果？因为终端里运行的程序根本不经过launch.json，它读的是你终端里真实敲下的那行命令。

第三条路是任务场景。VS Code的tasks.json可以定义构建任务或预处理任务，你可以把编译命令、参数、工作目录都写进去，然后在launch.json里用preLaunchTask字段指定在调试前先执行这个任务。这种方式适合那种"先编译再调试"的项目，C/C++项目里特别常用。参数既可以在task里传给编译器，也可以在launch.json里传给调试器，两者各管各的，不要混为一谈。

这三条路的边界很多新手分不清，我打个比方：launch.json是"调试器的启动说明书"，它告诉VS Code怎么把你的程序拉起来、以什么参数拉起来；tasks.json是"构建工具的任务清单"，它管的是编译、打包这些前置动作；终端则是最原始的执行环境，你想让程序怎么跑就怎么跑，灵活但每次都要手敲。

搞清楚这个之后，接下来的重点全是第一条路：在launch.json里通过args字段给调试中的程序传参。

2. launch.json里args字段的完整写法：Python、C/C++、Node.js逐个说

launch.json的位置在项目根目录下的.vscode文件夹里，名字固定叫launch.json。如果你还没创建过，点开VS Code左侧的"运行和调试"图标，再点"创建launch.json文件"，VS Code会按你当前打开的文件类型自动生成一个模板。生成之后你会看到类似这样的结构：

json复制{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "debugpy",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal"
        }
    ]
}

这里面最关键的两个字段：program指定要运行的程序，args就是要传给程序的命令行参数。args是一个JSON数组，数组里的每一个字符串元素，对应你程序收到的每一个参数。

2.1 Python项目的写法

假设你有一个train.py，平时在终端里是这样跑的：

bash复制python train.py --epochs 50 --batch-size 128 --data ./data/train.csv

那么在launch.json里就需要把args配成这样：

json复制{
    "name": "Python: 训练脚本",
    "type": "debugpy",
    "request": "launch",
    "program": "${file}",
    "console": "integratedTerminal",
    "args": [
        "--epochs", "50",
        "--batch-size", "128",
        "--data", "./data/train.csv"
    ]
}

注意看，--epochs和50是两个独立的数组元素。因为Python在解析命令行参数