code命令失效本质是path未包含其可执行文件路径：windows需添加vscode安装目录下的bin子路径，macos依赖/usr/local/bin/code符号链接，linux snap版需手动启用alias，且所有平台改path后必须重启终端生效。
code 命令在终端里打不出来？不是配置失败，而是根本没进系统 PATH —— 这是 Windows/macOS/Linux 三平台最常卡住的第一步，解决它比配 C/C++ 编译器还急。
Windows 上 code 不识别：PATH 没加对，不是没装
VSCode 安装时勾选“添加到 PATH”最省事，但很多人跳过了。手动补救时容易犯两个错：
一是把 Code.exe 所在目录（比如 C:\Users\Alice\AppData\Local\Programs\Microsoft VS Code）加进了 PATH，但这个目录下没有可执行的 code；
二是该目录下真正能调用的是 bin\code.cmd，必须把 bin 子目录加进去。
- 正确路径示例：
C:\Users\Alice\AppData\Local\Programs\Microsoft VS Code\bin - 验证方式：打开新 PowerShell 或 cmd，运行
where code，应返回.cmd文件路径 - 如果用脚本添加，注意分号分隔、不带引号、避免中文路径——PowerShell 中用
[Environment]::SetEnvironmentVariable("PATH", ... "User")只影响当前用户，重启终端才生效
macOS 上 code 报 command not found：符号链接没建或权限不足
macOS 不靠 PATH，靠 /usr/local/bin/code 这个符号链接指向 VSCode 内置 CLI 脚本。命令面板里执行 Shell Command: Install 'code' command in PATH 是标准流程，但它可能静默失败：
- 失败常见原因：终端不是从 VSCode 启动的（比如你用 iTerm），导致 shell 配置文件（
.zshrc等）没重载/usr/local/bin到 PATH - 手动修复：确认
/usr/local/bin/code存在且可执行（ls -l /usr/local/bin/code），再检查echo $PATH是否含/usr/local/bin；若无，追加export PATH="/usr/local/bin:$PATH"到~/.zshrc - 别用
sudo ln -sf自己硬链——VSCode 更新后会覆盖，且可能因 SIP 限制失效
Linux（Ubuntu/Debian）上 code 找不到：安装包类型决定 CLI 是否自带
Deb 包安装的 VSCode 默认注册 code 命令，但 Snap 版（Ubuntu Software 默认安装）默认不暴露 CLI，因为 Snap 的安全沙箱隔离了 PATH。
- 查安装方式：
dpkg -l | grep code（deb）或snap list | grep code（snap） - 如果是 snap 版，要么改用 deb 包重装，要么手动启用：
sudo snap alias code vscode.code，然后运行code前先source /etc/profile或新开终端 - PATH 验证同其他平台：
which code或command -v code，返回空就说明没暴露成功
跨平台通用陷阱：终端没读新环境变量
改完 PATH 后，旧终端进程不会自动更新环境变量，这是所有平台共通盲点。
- Windows：关掉所有 cmd/PowerShell，再开新的——任务管理器里杀掉
explorer.exe再重启也能刷新全局 PATH - macOS/Linux：改完
~/.zshrc或~/.bashrc后，必须source ~/.zshrc，或直接开新终端窗口 - VSCode 内置终端也独立继承环境：改完系统 PATH 后，要关闭再重开 VSCode，或在终端里执行
exec zsh（macOS/Linux）或refreshenv（PowerShell）
