code命令是系统级终端命令,非VSCode内置功能;需手动将VSCode的bin路径加入shell的PATH或配置alias,并确保VSCode集成终端以login shell启动或显式补全环境变量才能生效。

直接在终端里用 code 命令打开 VSCode,不是 VSCode 自身的功能,而是你 shell 环境里的命令别名或可执行文件路径配置。它和编辑器内部的“命令别名”(比如把 workbench.action.files.save 缩成 save)完全无关——这是系统级的终端命令映射。
macOS/Linux 下让 code 命令生效
VSCode 官方提供了 code 命令行工具,但默认不加入 PATH。你需要手动把它链接或 alias 进 shell 环境:
- 先确认 VSCode 已安装在
/Applications/Visual Studio Code.app(macOS)或/usr/share/code(Linux) - 执行一次 VSCode 内置命令:按
Cmd+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 回车(macOS);Linux 用户需手动运行/usr/share/code/bin/code --install-server或检查是否已启用 - 如果该命令不可用(比如用的是 .tar.gz 版本),就手动加 alias:
编辑~/.zshrc(macOS M1/M2 默认)或~/.bashrc,追加一行:alias code="/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code" - 保存后运行
source ~/.zshrc,再试code .—— 此时应能启动 VSCode 并打开当前目录
Windows 下配置 code 命令
Windows 用户通常不用手动配,只要安装时勾选了 Add to PATH(默认勾选),就能直接用 code。若失效,检查两点:
- 打开命令提示符,运行
where code,看是否返回类似C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code.cmd - 没结果?说明 PATH 未包含 VSCode 的
bin目录。手动把该路径加进系统环境变量,然后重启终端 - 注意:PowerShell 和 CMD 的 PATH 是共享的,但某些安全策略可能拦截
.cmd脚本执行,此时可改用完整路径调用:"C:\...\code.cmd" .
为什么 code 别名有时只在当前终端生效
因为 alias 是 shell 会话级的,不写入配置文件就不会持久化:
-
alias code="..."这种写法只对当前终端窗口有效,关掉就丢 - 必须写进 shell 配置文件(
~/.zshrc、~/.bash_profile或 Windows 的系统 PATH)才能全局可用 - 改完配置后,不要只靠
Reload Window,要新开一个终端或运行source ~/.zshrc才能加载新 alias - VSCode 内置终端是否加载这些配置,取决于它启动时是否以 login shell 模式运行(默认不是)。所以即使你在 iTerm 里
code好使,VSCode 终端里仍可能报 command not found —— 这是另一回事,得单独配terminal.integrated.env.osx
真正容易被忽略的是:VSCode 内置终端和你的系统终端不是同一个 shell 实例。你在外边配好了 code,不代表它在编辑器里自动继承。如果要在 VSCode 终端里也用 code,得确保它的集成终端环境变量完整,而不是只依赖 alias。


















