Windows用户应优先使用winget安装VSCode，运行winget install --id Microsoft.VisualStudioCode --exact可自动配置PATH和上下文菜单；macOS需先用Homebrew安装GUI版，再在VSCode中执行Shell Command命令注入PATH；Linux推荐官方.deb包而非snap，避免沙盒限制。
终端里直接装 VSCode 是可行的，但“怎么装”取决于你用的是什么系统——Windows、macOS、Linux 各自路径完全不同，且没有统一命令。盲目运行 apt install code 或 brew install vscode 很可能装错包、缺功能、甚至根本无法调用 code 命令。
Windows：用 winget 装最稳，别碰 Chocolatey
winget 是微软官方维护的 Windows 包管理器，预装在 Win10 1809+ 和所有 Win11 中，装 VSCode 不仅快，还能自动处理 PATH 和上下文菜单注册。
- 打开 PowerShell（普通用户权限即可），运行：
winget install --id Microsoft.VisualStudioCode --exact
- 加
--exact防止匹配到第三方打包的“VS Code Insiders”或带广告的镜像版 - 装完不用重启，
code --version立刻可用；如果提示 command not found，说明安装时没勾选 PATH —— 这时得手动补：setx PATH "%PATH%;C:\Users\<user>\AppData\Local\Programs\Microsoft VSCode\bin"</user>，然后新开终端 - Chocolatey 虽然也能装，但社区维护的
choco install vscode包默认不注册右键菜单、不加 PATH，还得额外执行choco install vscode.portable才能避免权限问题，纯属多一步风险
macOS：Homebrew 装的是 CLI 版，不是 GUI 应用
很多人以为 brew install --cask visualstudiocode 装完就能用 code，其实不是：它只把 App 拖进 /Applications，并不自动配置 shell PATH。真正要让 code 命令生效，必须靠 VSCode 自己来写配置。
- 先装 GUI 版：
brew install --cask visualstudiocode
- 再启动 VSCode，按
Cmd+Shift+P，输入Shell Command: Install 'code' command in PATH并执行 - VSCode 会往你的
~/.zshrc（macOS Catalina+）或~/.bash_profile里追加一行export PATH="/Applications/Visual Studio Code.app/Contents/Resources/app/bin:$PATH" - 关掉所有终端重开，再跑
which code，有输出才算成功；若无输出，检查 VSCode 是否真在/Applications下——拖到桌面或其它位置会导致路径推导失败
Linux（Ubuntu/Debian）：deb 包装完记得修依赖，别信 snap
Ubuntu 的 Snap 版 VSCode（snap install code --classic）看似方便，但被沙盒隔离后，code 命令根本进不了用户 PATH，也无法访问 /home 外的文件系统，调试 Docker、WSL 或远程开发时直接报错。
- 推荐用官方 .deb 包：
wget -O code.deb https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64 && sudo dpkg -i code.deb
- dpkg 可能报依赖缺失，立刻补：
sudo apt -f install -y
- 装完验证：
which code应返回/usr/bin/code；如果没反应，说明 deb 包没注册软链，手动加：sudo ln -sf /usr/share/code/bin/code /usr/bin/code
- 别用
apt install code—— Ubuntu 官源里那个是老版本（1.6x），且不带自动更新机制
为什么装完 code 还报 command not found？三个高频原因
这不是 VSCode 没装好，而是系统 PATH 没“认出”它。尤其 macOS/Linux 用户容易卡在这步。
-
which code无输出 → PATH 里确实没它；echo $PATH看一眼有没有含code相关路径 - VSCode 被挪动过位置（比如从
/Applications拖到桌面）→ 内置的 PATH 注入逻辑失效，只能手动改 shell 配置 - 用了 zsh 但配置写在
~/.bashrc里，或反过来 → 确认当前 shell 类型：echo $SHELL，然后去对应文件里加 export 行 - 终端没重载配置 → 改完
~/.zshrc后必须运行source ~/.zshrc，或直接关掉重开终端
真正麻烦的从来不是下载安装包，而是让 code 命令在任意终端里稳定可用。不同系统对“PATH 注入”的实现逻辑差异极大，靠一个命令打遍天下行不通；更关键的是，VSCode 自身的 PATH 注入功能只在 GUI 启动后才可触发——这意味着你得先手动打开一次应用，才能让它帮你配好命令行入口。
