打开项目这件事,键盘比鼠标快十倍。前提是你得先把 code 命令装进 PATH。
先解决一个尴尬:你敲 code 可能没反应
在终端里输入 code .,如果系统回你一句“code 不是内部或外部命令”,不是你敲错了,是 VS Code 的 code 命令还没进环境变量。
Windows 用户:
- 最省事的办法:重新运行 VS Code 安装程序,安装向导里有一个 “添加到 PATH” 的选项,默认勾选,一路下一步就行。
- 如果已经装好了但没勾:按
Win + S搜“环境变量” → 编辑系统环境变量 → 环境变量 → 在Path里新建一条,路径通常是C:\Users\你的用户名\AppData\Local\Programs\Microsoft VS Code\bin,保存后重启终端。
Mac 用户:
- 打开 VS Code,按
Cmd+Shift+P,搜索并运行Shell Command: Install 'code' command in PATH。 - 或者手动加:打开终端,执行
export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin",想永久生效就把这行加到~/.zshrc里。 - 验证:新开一个终端,输入
code --version,能看到版本号就成了。
装好之后,怎么用?
code 命令最爽的地方,是你不需要离开终端。项目在哪,你就 cd 过去,敲一行命令,它自己就开了。
场景一:打开一个新窗口(不覆盖当前项目)
假设你正在终端里待着,手头已经开着一个 VS Code 窗口,但你突然想再开一个项目。
code -n ~/projects/new-thing

-n 就是 --new-window,强制新开一个窗口。适合同时维护多个项目、需要对照着看的时候。
场景二:在当前窗口打开(覆盖当前项目)
如果你不想开新窗口,就想把当前这个 VS Code 窗口切换到另一个项目:
code ~/projects/another-thing
或者明确一点:
code -r ~/projects/another-thing
-r 是 --reuse-window,复用当前窗口。适合“我就是要切过去看看”的场景。
场景三:以 Workspace 形式打开
如果你有一个 .code-workspace 文件(多根工作区配置),想直接打开它:
code ~/work/my-workspace.code-workspace
这种方式会把工作区里定义的所有文件夹都加载进来,适合那种“一个窗口里同时看前后端两个仓库”的配置。
如果你想把某个文件夹添加到当前的 VS Code 工作区里,可以使用如下命令
code --add ~/projects/another-folder
或者简写为
code --a ~/projects/another-folder
```### 场景四:Insiders 用户怎么办

VS Code Insiders 的命令是 **`code-insiders`**,用法和 `code` 完全一样:
```bash
code-insiders -n ~/projects/new-thing
code-insiders -r ~/projects/another-thing
code-insiders ~/work/my-workspace.code-workspace
前提是 Insiders 版本的 code-insiders 命令也加进了 PATH,安装时默认会加,或者手动把它的 bin 目录加进去。
一个更偷懒的写法
如果你经常要打开“当前目录”,其实有个更短的写法:
code .
这个 . 就是“当前目录”,它会用当前目录作为项目根打开。和 code -n . 的区别是:-n 强制新窗口,不加 -n 则复用当前窗口(如果 VS Code 已经有窗口开着)。
你现在是用鼠标点图标打开项目,还是用 code 命令?如果还没用上,今天花两分钟配一下 PATH,以后打开项目就只需要一行命令。
如果你像使用code的更多能力,直接使用命令code --help就可以学到跟过命令了。