code命令不存在需先确认VS Code是否注册到PATH:macOS通过命令面板安装shell命令,Windows重装时勾选Add to PATH,Linux检查安装方式;code .与code ./无区别,但code后不可无参数;后台启动用-n,--wait用于脚本等待;多路径需注意引号和空格。

code 命令不存在?先确认 VS Code 已注册到 PATH
直接在终端输入 code . 报错 command not found: code,说明 VS Code 没有把命令行工具安装进系统路径。这不是你装错了,而是 macOS / Windows / Linux 安装时默认不勾选「Add to PATH」。
解决方法取决于系统:
- macOS:打开 VS Code → 左下角齿轮图标 → Command Palette(
Cmd+Shift+P)→ 输入Shell Command: Install 'code' command in PATH→ 回车执行 - Windows:重装 VS Code 时勾选
Add to PATH;或使用已安装的 VS Code 打开命令面板,运行同名命令(部分版本叫Shell Command: Install 'code' command in PATH) - Linux(.deb/.rpm 包安装):通常自带
code命令;若无,检查是否用 snap 安装 —— snap 版本的code命令默认可用,但可能受限于 snap 的权限隔离
code . 和 code ./ 有区别吗?
没有实质区别。code . 是最常用写法,表示“用 VS Code 打开当前目录”;code ./ 会被 shell 展开为相同路径,VS Code 内部也按相同逻辑处理。但注意:code 后面**不能只写空格或换行**,否则会启动一个空白窗口,而不是打开当前项目。
常见误操作:
-
code(后面没参数)→ 启动新窗口,不关联任何文件夹 -
code myproject→ 打开相对路径myproject/,但如果该目录不存在,VS Code 不报错,而是新建一个空工作区并命名为myproject -
code ~/myproject→ 正确,支持绝对路径和波浪线展开
想后台启动不阻塞终端?加 -n 或 --new-window
在某些终端(比如 zsh 默认配置、或通过 SSH 连入的远程 shell)中,直接运行 code . 可能会让终端卡住,光标不动,仿佛命令没结束 —— 实际上 VS Code 启动后,进程仍在前台挂起,等待退出信号。
这不是 bug,是 VS Code 的默认行为。解决方式很简单:
- 加
-n参数:code -n .→ 强制新开一个独立窗口,且立即返回终端控制权 - 加
--wait是反向操作:让终端等你关闭编辑器才继续,适合写成脚本做后续动作(如code --wait . && git add .) - 如果已经卡住,按
Ctrl+Z暂停,再执行bg把它丢进后台(不推荐长期依赖这个)
打开特定文件或多个文件夹?参数顺序和引号要注意
code 支持同时打开多个路径,但顺序和空格处理容易出错:
-
code src/index.ts README.md→ 正确:打开两个文件(标签页形式) -
code "src/my file.ts"→ 必须加双引号,否则空格被 shell 当作分隔符,变成code src/my和file.ts两个参数 -
code frontend/ backend/→ 打开两个文件夹,以多根工作区(multi-root workspace)形式呈现 -
code . --goto src/index.ts:10:5→ 直接跳转到第 10 行第 5 列,调试或 CI 后快速定位时很有用
复杂路径、含空格或特殊字符的项目名,宁可多打一对引号,也不要靠记忆猜转义规则。

















