VSCode的code命令不生效，90%因PATH未正确配置：Windows需手动添加AppData下bin路径并重启终端；macOS/Linux须按shell类型修改对应配置文件（如zshrc），添加应用内bin路径并source生效；共存Insiders版应单独配置code-insiders，避免路径冲突。
VSCode 命令行工具 code 安装后不生效，90% 是因为环境变量根本没写进系统 PATH —— 它不会自动添加，必须手动配置，且 Windows/macOS/Linux 写法和验证方式完全不同。
Windows：安装时勾选 Add to PATH ≠ 一定生效
VSCode 安装向导里那个「Add to PATH」选项，只在安装过程中起作用。如果安装完发现 code --version 报“不是内部或外部命令”，说明 PATH 没落进系统变量里。
- 打开「系统属性 → 高级 → 环境变量」，在「系统变量」中找到
Path，点击「编辑」 - 新增一条路径：
C:\Users\<用户名>\AppData\Local\Programs\Microsoft VS Code\bin（注意：不是安装目录下的bin，而是用户本地 AppData 下的路径） - 别用「浏览文件夹」去选——它会自动加引号，导致 PATH 解析失败；必须手动粘贴、不带引号
- 改完后，**关掉所有 CMD/PowerShell 窗口，新开一个再试
code --version**
macOS/Linux：PATH 要写进 shell 配置文件，且得区分 zsh/bash
2026 年 macOS 默认 shell 是 zsh，不是 bash。如果你往 ~/.bashrc 里加了 PATH，但终端实际跑的是 zsh，code 就永远找不到。
- 先确认当前 shell：
echo $SHELL，输出是/bin/zsh就改~/.zshrc，是/bin/bash才改~/.bashrc - 在对应文件末尾加一行：
export PATH="/Applications/Visual Studio Code.app/Contents/Resources/app/bin:$PATH"（macOS）或export PATH="/usr/share/code/bin:$PATH"（Linux deb/rpm 安装版） - 执行
source ~/.zshrc（或对应文件），再运行code --version - 如果提示 permission denied，检查
code文件是否可执行：ls -l /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code，缺失 x 权限就补：chmod +x /Applications/Visual Studio Code.app/Contents/Resources/app/bin/code
VSCode Insiders 和正式版共存时，PATH 不能混用
Insiders 版本的 code 命令路径跟正式版不同，强行复用会导致命令指向错误版本，甚至启动失败。
- Insiders 的 PATH 应该是：
/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin（macOS）或C:\Users\<用户名>\AppData\Local\Programs\Microsoft VS Code Insiders\bin（Windows） - 两个版本都装了？不要把两条路径都塞进同一个 PATH。更稳妥的做法是：只配正式版 PATH，Insiders 用
code-insiders命令（它自带注册，无需额外 PATH） - 验证方式：
which code和which code-insiders输出路径应严格分离，不能指向同一个 bin 目录
PATH 配对了但 code 还打不开文件夹？检查空格和编码
哪怕 PATH 正确，code my\ project 或 code "my project" 在某些终端里仍会失败，根源常被忽略：
- 路径含空格时，PowerShell 默认不转义反斜杠，
code C:\my project实际传给 VSCode 的是C:\my和project两个参数 → 必须用双引号包裹：code "C:\my project" - WSL 中若从 Windows 启动 VSCode，
code .可能报错「Unable to resolve non-existing path」→ 不要用code .，改用code /mnt/c/Users/xxx/project（显式写 WSL 路径） - 终端编码为 UTF-8 但路径含中文，某些旧版 PowerShell 会乱码 → 改用 Windows Terminal 或 VSCode 内置终端，它们默认支持 Unicode 路径
最常被跳过的一步：PATH 更新后，VSCode 内置终端不会自动继承新环境——它继承的是启动 VSCode 时父进程的环境。所以改完 PATH，必须彻底退出 VSCode（包括托盘进程），再重新打开，内置终端里的 code 才真正可用。
