VSCode所有启动参数必须通过终端执行code --help查看,GUI启动完全不读取;参数仅临时生效,如--disable-extensions排查插件问题、--no-reopen-last --folder-uri组合指定工作区、--wait仅首次启动阻塞,路径须绝对且带file://前缀。

VSCode 内置命令行参数不靠设置界面查,必须用 code --help 直接看;GUI 启动完全无视这些参数,只在终端执行 code 命令时生效。
怎么快速查所有可用参数
打开终端,直接运行:
code --help
输出的是 VS Code 当前安装版本支持的全部 flag。注意三点:
-
--help不会启动编辑器,只打印帮助文本,适合脚本中预检 - 不同平台(macOS/Windows/Linux)输出略有差异,比如 Windows 上可能多出
--win类参数 - 某些参数如
--locale或--user-data-dir在旧版 VS Code 中不可用,--help能帮你确认当前环境是否支持
常见但容易误用的启动参数场景
这些参数不是“配一次就永久生效”的开关,每次想用都得显式传入:
-
--disable-extensions:临时禁用所有扩展,排查卡顿或崩溃首选,但不会影响已启用的全局设置 -
--no-reopen-last --folder-uri file:///abs/path:必须组合使用,单独--no-reopen-last仍可能恢复窗口布局 -
--read-only /etc/hosts:只读模式打开文件,保留跳转和高亮,但禁止保存——路径不能是相对路径或带波浪线~ -
--wait:只在首次启动时阻塞,已有后台进程时立刻返回;配合脚本使用建议加--new-window避免复用
launch.json 的 args 和 code 命令参数是两套体系
很多人混淆这两者:code --disable-extensions 控制 VS Code 自身行为,而 launch.json 里的 args 字段只影响你调试的 Python/Java 程序本身。
-
launch.json中的args必须是 JSON 数组,写成"--input data.txt"会失败,正确是["--input", "data.txt"] -
code --devtools打开的是 VS Code 的开发者工具,和你的程序控制台无关;console: "integratedTerminal"才决定 Python 输出在哪显示 -
--settings不是合法参数,任何类似写法都会被静默忽略——VS Code 不会报错,也不会生效
路径和协议细节最容易踩坑
VS Code 对路径格式极其敏感,尤其涉及 --folder-uri 和 --read-only:
-
--folder-uri必须带file://协议前缀,且路径为绝对路径;~/project或./src全部无效 - macOS/Linux 上路径空格需用引号包裹:
code --folder-uri "file:///Users/name/my project" - Windows 上推荐统一用正斜杠:
file:///C:/Users/name/project,避免反斜杠转义问题 -
code .是唯一依赖当前 shell 路径的快捷写法,其余所有参数都不受terminal.integrated.cwd设置影响
真正难的不是记住参数名,而是理解每个参数的作用边界:它改的是哪个进程、是否跨子进程、是否继承环境变量。比如 --locale=zh-cn 只刷 UI,终端语言照旧;--user-data-dir 隔离的是整个用户态,但远程 SSH 连接后,远端 server 完全不认本地这个参数。


















