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