VS Code的CLI命令code可直接启动编辑器、打开文件或管理扩展,需确保安装时勾选“Add to PATH”;常用命令包括code .打开当前目录、code --wait等待编辑关闭、code --diff比较文件、code --goto跳转到指定行列,支持扩展安装卸载与日志调试,配合别名和远程开发更高效。

VS Code 的命令行接口(CLI)让你不用打开图形界面就能快速启动编辑器、打开文件、管理扩展,甚至集成到脚本或终端工作流中。核心命令是 code,安装 VS Code 时默认勾选“Add to PATH”才会可用——没生效的话,先检查是否已启用该选项,或手动把 VS Code 的可执行目录加入系统环境变量。
启动 VS Code 和打开文件/文件夹
最常用也最直接的用法:
- code:直接打开当前目录的 VS Code 窗口(如果已运行,则聚焦已有窗口)
- code .:同上,显式指定当前目录,推荐写法,避免歧义
- code index.js:打开单个文件,若未运行则启动新实例;若已运行,通常在当前窗口新标签页中打开
- code src/:打开整个文件夹,作为工作区根目录加载
- code --new-window .:强制新建一个独立窗口,不复用已有实例
常用实用参数与行为控制
几个高频又容易忽略的选项,能显著提升效率:
-
--wait:命令会阻塞终端,直到编辑器关闭才返回。适合脚本中“编辑完再继续”,比如
code --wait settings.json && echo "配置已保存" -
--diff
:直接进入并排比较模式,跳过手动打开“命令面板 → Compare Active File With…” -
--goto
: :打开文件并精准跳转到某行某列,例如[: ] code --goto app.ts:42:8 -
--reuse-window:明确复用已有窗口(默认行为),和
--new-window对应,适合写进别名或自动化命令中 - --disable-extensions:临时禁用所有扩展,用于排查插件冲突或性能问题
扩展管理与配置调试
CLI 也能完成部分原本只能在 UI 中操作的任务:
-
code --list-extensions:列出已安装扩展的 ID(如
ms-python.python) -
code --install-extension ms-python.python:安装指定扩展,支持本地
.vsix文件路径 - code --uninstall-extension esbenp.prettier-vscode:卸载扩展
- code --verbose:输出详细日志,启动卡顿或黑屏时排查问题的第一步
- code --log extensionHost:专门记录扩展宿主日志,定位扩展异常更精准
进阶技巧与注意事项
一些真实场景中省时省力的小技巧:
- 在 Git Bash 或 Zsh 中设置别名,比如
alias vsc='code --wait',配合git commit编辑器使用 - Windows 用户注意:PowerShell 默认可能无法识别
code,可改用 Windows Terminal 或确保 VS Code 安装时勾选了 PowerShell 支持 - 远程开发(SSH / WSL / Containers)下,
code命令依然有效,但实际调用的是远程端的 VS Code Server,无需本地安装 -
macOS 用户首次运行
code可能提示“无法验证开发者”,需右键应用 → “打开”绕过一次 Gatekeeper - Linux 下若提示 command not found,请确认 VS Code 是通过官方 .deb/.rpm 包安装,或手动软链:
sudo ln -s /usr/share/code/bin/code /usr/local/bin/code
基本上就这些。CLI 不复杂但容易忽略,掌握几个关键参数后,日常开发、脚本集成、故障排查都会更顺手。










