VSCode启动参数(CLI)详解

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）和多根工作区也依赖特定参数启动：

佳蓝智能应答系统

类似智能机器人程序，以聊天对话框的界面显示，通过输入问题、或点击交谈记录中的超链接进行查询，从而获取访客需要了解的资料等信息。系统自动保留用户访问信息及操作记录。后台有详细的设置和查询模块。适用领域：无人职守的客服系统自助问答系统智能机器人开发文档、资源管理系统……基本功能：设置对话界面的显示参数设置各类展示广告根据来访次数显示不同的欢迎词整合其他程序。

4

查看详情

• --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 版本中可用

以上就是VSCode启动参数(CLI)详解的详细内容，更多请关注php中文网其它相关文章！