VSCode 命令行参数支持灵活控制启动行为，如复用窗口（-r）、跳转行列（-g）、禁用扩展（--disable-extensions）、远程开发（--remote）、调试扩展（--inspect-extensions）等，提升自动化与开发效率。
VSCode 启动时可通过命令行（CLI）传入多种参数，灵活控制编辑器行为，比如打开指定文件、禁用扩展、切换工作区、启用开发模式等。掌握这些参数能显著提升日常开发效率，尤其适合自动化脚本、CI/CD 集成或调试场景。
常用启动参数与用途
以下是最实用且高频的 CLI 参数，适用于 Windows/macOS/Linux（注意路径中空格需加引号）：
- -r 或 --reuse-window：复用已打开的 VSCode 窗口，避免重复启动新实例
- -n 或 --new-window：强制新建窗口（即使已有实例运行）
-
-g 或 --goto file:line[:column]：直接跳转到指定文件的某行（或行列），例如
code -g "src/index.ts:12:5" -
--folder-uri uri：以 URI 方式打开文件夹（支持
file://、vscode-remote://等） - --diff file1 file2：并排比较两个文件
- --disable-extensions：禁用所有已安装扩展，用于排查扩展冲突问题
- --disable-gpu：禁用 GPU 加速（解决某些系统渲染异常）
-
--log level：设置日志级别（如
trace、debug、info），配合--logExtensionHostCommunication可深入调试扩展通信
远程开发与多根工作区控制
VSCode 的远程开发（SSH/Containers/WSL）和多根工作区也依赖特定参数启动：
-
--remote ssh-remote+host：直接连接远程 SSH 主机，例如
code --remote "ssh-remote+myserver" ./project - --folder-uri vscode-remote://ssh-xxx/...：更精确地指定远程文件夹 URI
- --add path：向当前窗口添加一个文件夹（仅在已有窗口且未禁用多根时生效）
- --wait：让命令阻塞，直到编辑器关闭（常用于 shell 脚本中等待用户编辑完成）
调试与开发相关参数
对插件开发者或想深度调试 VSCode 自身行为的用户，这些参数很关键：
- --inspect-extensions port：启用扩展主机的 Chrome DevTools 调试（默认端口 9229）
- --extensionDevelopmentPath path：加载本地扩展进行开发测试
- --extensionTestsPath path：运行扩展的测试套件
- --verbose：输出详细启动日志（含模块加载、配置解析过程）
-
--prof-startup：生成启动性能分析报告（保存为
cpu-*.cpuprofile文件）
注意事项与小技巧
使用 CLI 参数时容易忽略但影响体验的细节：
- 参数顺序一般不敏感，但 --goto 和 --diff 必须放在目标路径之前
- 在 macOS 上首次通过 CLI 启动 VSCode，需先执行
shell command安装（菜单栏：Shell Command → Install 'code' command in PATH） - Windows 用户若遇到“找不到 code 命令”，需检查是否勾选了“Add to PATH”安装选项，或手动添加
%LOCALAPPDATA%\Programs\Microsoft VS Code\bin - 多个参数可组合使用，例如
code --disable-extensions --log debug -g "readme.md:3" - 所有参数可通过
code --help查看完整列表，部分实验性参数（如--enable-proposed-api）仅在 Insiders 版本中可用
