macOS终端执行code命令报错需在VS Code中运行“Shell Command: Install 'code' command in PATH”并重启终端；Windows需检查PATH是否含VS Code路径，未生效则重装勾选“Add to PATH”；强制新窗口须用code --new-window .。

macOS 终端执行 code 命令报 command not found: code

这不是 VS Code 没装好，而是 Shell 根本不认识 code 这个命令。VS Code 安装后默认不把 CLI 工具写入 PATH，必须手动触发安装逻辑。

唯一可靠做法：在任意已打开的 VS Code 窗口中，按 Cmd+Shift+P 打开命令面板，输入并运行 Shell Command: Install 'code' command in PATH。完成后关闭并重启终端（不是 VS Code），再试 code --new-window .。

别用软链或手改 ~/.zshrc 加 alias——VS Code 官方安装器会根据你当前 Shell 类型（zsh/bash/fish）自动写对配置行，手动干预反而容易因引号、空格、转义出错。

Windows 上 code 命令不可用但安装时勾选了“添加到 PATH”

常见于 Windows 11 + 用户账户控制（UAC）较严的环境：安装程序声称添加了 PATH，但实际只写入了当前用户的环境变量，且未广播给已运行的终端进程。

验证方式：打开新终端（不是已有窗口），执行 echo %PATH%，搜索是否有 Microsoft\VS Code 字样路径；没有就说明没生效。

补救步骤：

• 重新运行 VS Code 安装包（.exe），勾选“Add to PATH”再点“修复”
• 或手动把 C:\Users\\AppData\Local\Programs\Microsoft VS Code\bin 加进系统环境变量 PATH
• 加完后必须新开一个 CMD/PowerShell/Windows Terminal 窗口，旧窗口不会自动刷新 PATH

code . 总是在旧窗口里打开文件夹，不是新窗口

这是 VS Code 默认的单实例行为，不是 bug。它优先复用已有窗口，除非你明确告诉它“不要复用”。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

要强制新窗口，必须加 --new-window 参数：

• code --new-window . —— 当前目录，干净新窗口
• code --new-window /path/to/project —— 指定路径，新窗口
• code --reuse-window . —— 显式要求复用（和 code . 效果一致）

漏掉 --new-window 就等于没写，点号 . 也不能省——code --new-window 不带路径会启动空窗口，不是当前目录。

想双击桌面图标或 Win+R 输入直接启动特定工作区

VS Code 本身不提供“一键打开 .code-workspace 文件”的全局快捷键，因为工作区是进程级隔离的，每个 .code-workspace 启动的是独立进程，不能靠设置切换。

可行方案只有两个：

• 在桌面建 shell 脚本（macOS/Linux）或批处理（Windows），内容为 code /full/path/to/my.project.code-workspace，赋予可执行权限后双击运行
• Windows 下把 code "C:\path\to\my.project.code-workspace" 做成快捷方式（.lnk），右键属性里确认“起始位置”设为该路径所在目录

注意路径必须是绝对路径，相对路径在桌面双击时会以桌面为基准，大概率打不开。