code命令找不到的根本原因是VSCode未将CLI工具注册到系统PATH;macOS需在菜单中执行“Install 'code' command in PATH”,Windows安装时须勾选“Add to PATH”,Linux解压版需手动创建软链接。

vscode 命令行启动失败:找不到 code 命令
直接在终端输入 code . 报错 command not found: code,说明 VSCode 没有把命令行工具安装进系统 PATH。这不是 VSCode 本身没装好,而是「命令行工具」这个可选组件默认没启用。
解决方法取决于你的操作系统:
- macOS:打开 VSCode → 左上角菜单栏 Code → Install 'code' command in PATH,执行后重启终端
- Windows(官方安装包):安装时勾选 Add to PATH;若已安装,可重运行安装程序并修复,或手动把
C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\bin加入系统环境变量 PATH - Linux(.deb/.rpm 包):通常自带
code命令;若用 tarball 解压版,需手动创建软链接,例如:sudo ln -s /path/to/VSCode-linux-x64/bin/code /usr/local/bin/code
启动当前目录但窗口不聚焦或卡住
执行 code . 后 VSCode 窗口没弹到前台,或者终端卡住不返回提示符,本质是进程阻塞模式问题。
- 默认
code .是前台阻塞运行(尤其在 Linux/macOS 的某些 shell 下),加-n参数强制新开窗口并后台运行:code -n . - 如果只想启动并立即交还终端控制权,推荐加
-w(wait)配合&:code -w . &—— 但注意-w实际用于等待文件关闭,日常启动一般不用 - 更稳妥的做法是始终加上
-n,避免和已有窗口混在一起导致焦点丢失
用 code 打开子目录或特定文件
code 命令远不止支持当前目录,它的路径参数很灵活,但容易因相对路径处理出错。
- 打开上级目录:
code .. - 打开同级的
src目录:code src(无需写./src,除非路径含空格或特殊字符) - 同时打开多个目录或文件:
code src tests/index.js - 如果路径含空格,必须用引号包裹:
code "my project" - 注意:VSCode 会把每个参数当作独立的「工作区根目录」,不是递归包含关系
Windows PowerShell 中执行 code . 报错权限或执行策略
PowerShell 默认禁止运行未签名脚本,而 VSCode 的 code 在 Windows 上实际是 PowerShell 脚本包装器(code.cmd 调用 code.ps1),可能触发策略拦截。
- 临时绕过(仅当前会话):
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
- 更安全的做法是改用
cmd或 Windows Terminal 默认配置为 Command Prompt - 或者直接调用 cmd 版本:
code.cmd .(跳过 PowerShell 层)
VSCode 的 code 命令看似简单,但跨平台 PATH 注册、shell 阻塞行为、PowerShell 执行策略这几个点,最容易让人卡住几分钟——尤其是刚重装系统或换新电脑时。别在报错信息里反复猜,先确认 code --version 能否执行,这一步就筛掉了八成问题。











