在 launch.json 中配置 args 字段需使用 JSON 数组格式,每个元素为独立参数;含空格或引号的参数须整体加引号并转义;args 传给目标程序而非运行时(如 node),不同语言行为一致;参数未生效常因 program 路径或 cwd 设置错误。

在 launch.json 里配置 args 字段最直接
VSCode 调试时传参,核心就是改项目根目录下 .vscode/launch.json 文件里的 args 数组。它和终端里敲命令时的空格分隔参数行为一致,但必须是 JSON 数组格式。
常见错误是把参数写成字符串(比如 "args": "--port 3000"),这会导致整个字符串被当做一个参数传给程序,而不是两个独立参数。
-
args值必须是数组,每个元素是一个独立参数,例如:"args": ["--port", "3000", "--debug"] - 含空格的参数(如路径)要整体作为一个数组元素,用引号包裹:
"args": ["--input", "./data/file name.txt"] - 如果参数本身含双引号(如 JSON 字符串),需用反斜杠转义:
"args": ["--config", "{\"log\":true}""] - Node.js 用户注意:
args传给的是你的脚本,不是node进程;想传参给 Node(如--inspect),得写进runtimeArgs
Python、Go、Rust 等语言的 args 行为完全一致
不管用什么语言调试,只要调试器支持 launch.json(比如 Python 的 ms-python.python、Go 的 golang.go、Rust 的 vadimcn.vscode-lldb),args 字段含义都一样:最终传给目标程序的 os.Args[1:] 或等价物。
区别只在启动方式——比如 Python 调试器默认执行 python your_script.py,所以 args 就是 your_script.py 后面的部分;而 Go 调试器运行的是编译后的二进制,args 就是该二进制的命令行参数。
- Python 示例:
"args": ["-v", "/path/to/config.yaml"]→ 程序内sys.argv是["script.py", "-v", "/path/to/config.yaml"] - Go 示例:
"args": ["--env=prod", "--timeout=30s"]→os.Args是[binary, "--env=prod", "--timeout=30s"] - 环境变量不走
args,得用env字段单独配
调试时临时改参数?用 console 模式或加断点再修改
每次改 launch.json 再重启调试太慢。更灵活的方式是:启用 console(终端内调试),或在代码开头设断点,手动调用 process.argv / sys.argv 赋值模拟参数。
但这只是开发期快速验证,不能替代 args 配置——因为真实部署或 CI 场景下,参数只能靠启动时注入。
- 在
launch.json中设"console": "integratedTerminal",调试会起一个带完整 shell 的终端,你甚至可以手动敲命令测试 - Node.js 脚本开头加
if (require.main === module) process.argv = ['node', 'script.js', '--test'];,仅用于本地调试绕过配置 - Python 里类似:
if __name__ == '__main__': sys.argv = ['script.py', '--dry-run'],但记得注释掉再提交
参数没生效?先检查 program 和 cwd 是否正确
传参失败,80% 不是 args 写错了,而是 program 路径指向了错误文件,或者 cwd(工作目录)导致相对路径解析失败,结果程序根本没读到参数。
尤其当项目有构建步骤(如 TypeScript 编译、Webpack 打包)时,program 应该指向输出后的 JS/二进制文件,而不是源码;否则调试器可能静默失败或加载旧版本。
- 打开调试控制台(
Debug Console),输入process.argv(Node)或sys.argv(Python)确认实际收到的参数 - 检查
program路径是否为绝对路径,或相对于cwd正确;建议全用${workspaceFolder}变量避免歧义 - 如果用了
preLaunchTask,确保任务成功完成后再启动调试,否则program文件可能还不存在
args 字段的 JSON 数组格式、program 与 cwd 的协同、以及不同语言调试器对“目标程序”的界定,这几个地方最容易卡住人。


















