Windows上code命令失效大概率因安装模式选错：User Installer仅注入用户PATH，部分终端（如PowerShell）读取系统PATH而找不到；System Installer写入系统PATH但需管理员权限。
Windows 上 code 命令失效，大概率是装错了安装模式
VS Code 的 code 命令能否在终端中直接使用，和你当初选的是 User Installer 还是 System Installer 强相关。User Installer（用户版）默认不写入系统级 PATH，即使勾选了“添加到 PATH”，也只注入到当前用户的环境变量中——这在多数情况下够用；但如果你用的是 Windows Terminal、PowerShell 或某些第三方终端（比如 Git Bash），它们可能读取的是系统级 PATH，导致 code 找不到。
常见错误现象：
- 在 CMD 或 PowerShell 中输入 code --version 提示“不是内部或外部命令”
- 重启终端后 code 仍不可用，但设置里明明勾选了“添加到 PATH”
- 检查当前 PATH 是否包含 VS Code 安装路径：运行
echo %PATH%，搜索Code或Microsoft VS Code - 如果没出现，说明 PATH 没生效：用户版安装后需重启终端，或手动执行
refreshenv（需安装chocolatey）或注销重登录 - System Installer（系统版）会写入系统 PATH，对所有终端生效，但需要管理员权限安装，且 UAC 弹窗频繁，日常开发体验反而更差
code 命令在 macOS 上必须手动启用
macOS 的 VS Code 安装包（.dmg）默认不注册 code 命令，哪怕你把它拖进 Applications 文件夹，终端里也直接报错。这不是 bug，是设计使然——苹果沙盒机制限制了自动 PATH 注入。
必须手动触发一次注册：
- 启动 VS Code
- 按 Cmd+Shift+P 打开命令面板
- 输入 shell command，选择 Install 'code' command in PATH
- 该操作本质是往
~/.zshrc（或~/.bash_profile）里追加一行export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin" - 执行完别忘了运行
source ~/.zshrc或新开一个终端 - 如果用的是 Oh My Zsh 或其他 shell 配置框架，确认它确实加载了
.zshrc
Linux 下 code 不可用？先看你是怎么装的
Linux 用户最容易踩的坑是：用 sudo apt install 装了官方 .deb 包，却没意识到它只提供 code 命令的符号链接，而实际二进制路径依赖于安装时的解压位置。更麻烦的是，某些发行版（如 Ubuntu Snap 版本）会把 code 装进沙盒，导致 code --install-extension 失败或插件无法访问本地文件系统。
- 优先用官网 .deb 或 .rpm 包，避免 Snap 版本（除非你明确需要沙盒隔离）
- 装完立刻验证：
which code应返回/usr/bin/code；ls -l /usr/bin/code应指向 VS Code 安装目录下的真实二进制 - 如果用 tar.gz 手动解压，必须自己把 bin 目录加进 PATH，例如：
export PATH="/path/to/VSCode-linux-x64/bin:$PATH" - 部分 Linux 终端（如 GNOME Terminal）启动时不会重新加载
~/.bashrc，需手动 source 或改用 login shell
跨平台统一行为：别信“安装完就自动可用”
VS Code 官方从不承诺 code 命令开箱即用。它的行为高度依赖操作系统策略、shell 类型、终端启动方式，甚至是否启用了 Windows Subsystem for Linux（WSL）。
- Windows WSL 环境下，宿主机的
code命令默认不可见；需在 WSL 中单独运行code --install-server并配置远程连接 - macOS 使用
zsh后，旧的.bash_profile配置可能被忽略，PATH 更新容易失效 - Linux 某些桌面环境（如 KDE）的终端启动方式不读取 shell 配置文件，PATH 修改后需重启桌面或改用“Run Command”方式启动终端
最稳妥的做法：每次装完 VS Code，第一件事就是打开终端，敲 code --version。失败就查 PATH，别跳过这步——后面所有插件命令、调试配置、任务脚本都依赖它。
