code命令在终端报“command not found”是因为未加入系统PATH：Windows安装时默认勾选Add to PATH，macOS/Linux需通过VSCode命令面板执行“Shell Command: Install 'code' command in PATH”并重启终端验证。
直接用命令行安装 VSCode 不是标准做法——VSCode 官方不提供 apt install code 或 brew install vscode 这类原生包管理器一键安装（除非你用的是微软签名的官方仓库）。所谓“命令行安装”，实际是指：用终端触发下载 + 手动执行安装包，或通过系统包管理器添加官方源后安装。不同系统差异很大，搞错路径或源会导致 code 命令不可用、自动更新失效、甚至插件加载异常。
Windows：别信 choco install vscode，优先走 User Installer + PATH
PowerShell 或 CMD 里运行 choco install vscode 看似方便，但 Chocolatey 安装的是 System Installer 版本，需要管理员权限，UAC 弹窗频繁，且后续自动更新常失败。更稳妥的方式是：
① 用 Invoke-WebRequest 下载 User Installer 包（如 VSCodeUserSetup-x64-1.94.2.exe）到本地；
② 静默安装：Start-Process -FilePath ".\VSCodeUserSetup-x64-1.94.2.exe" -ArgumentList "/verysilent /suppressmsgboxes /norestart" -Wait；
③ 关键：必须手动确认 code 命令是否可用——打开新终端，输入 code --version，若报“不是内部或外部命令”，说明安装时没勾选“添加到 PATH”，得重装或手动把 C:\Users\<username>\AppData\Local\Programs\Microsoft VS Code\bin</username> 加进系统环境变量。
macOS：用 brew 装要加微软官方 tap，否则是旧版
直接 brew install --cask visualstudiocode 安装的是社区维护的 cask，更新滞后、偶尔签名失效。正确流程是：
① 先添加微软官方源：brew tap homebrew/cask-versions && brew tap microsoft/vscode；
② 再安装：brew install --cask visualstudiocode；
③ 安装后必须在 VS Code 内执行一次：Cmd+Shift+P → "Shell Command: Install 'code' command in PATH"，否则终端里 code . 会报错“command not found”。这个步骤不能跳过，也不是安装脚本自动完成的。
Linux（Ubuntu/Debian）：用 apt 必须导入 GPG 密钥和官方源
很多教程让你直接 sudo apt install code，但这是错的——Ubuntu 官方仓库里根本没有 code 包。正确方式是：
① 下载并安装微软 GPG 密钥：curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /usr/share/keyrings/packages.microsoft.gpg > /dev/null；
② 添加官方 APT 源：echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list；
③ 更新并安装：sudo apt update && sudo apt install code；
⚠️ 注意：如果跳过第①步，apt update 会报 GPG 错误；如果用 deb https://code.visualstudio.com/ 这类错误源地址，会 404。
最易被忽略的一点：无论哪个系统，命令行安装完都必须验证 code --version 和 code . 是否真正生效。很多“安装成功”的假象，其实只是 GUI 启动了，而终端集成完全没通——这直接影响你后续用 Git、脚本、CI 工具调用 VS Code 的所有场景。
