Linux下Debian/Ubuntu用户应通过官方APT仓库一键安装VSCode:先导入微软GPG密钥并添加源,再执行sudo apt update && sudo apt install code,安装后支持自动更新且无需手动配置PATH。

Linux 下用包管理器一键安装 VSCode(Debian/Ubuntu)
Debian/Ubuntu 用户别去官网下 .deb 包再 dpkg -i,容易缺依赖还难更新。直接走官方 APT 仓库最稳:
先加微软 GPG 密钥和源:
curl -fsSL https://packages.microsoft.com/key/microsoft.asc | gpg --dearmor -o /usr/share/keyrings/microsoft-archive-keyring.gpg echo "deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/microsoft-archive-keyring.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
- 装的是
code命令,不是code-insiders -
apt upgrade时会自动更新 VSCode,不用手动管 - 如果提示
unable to locate package code,大概率是源地址写错或没执行apt update
macOS 用 Homebrew 安装 VSCode(含 GUI 启动支持)
Homebrew 是 macOS 上最接近“一条命令”的方案,但要注意:只运行 brew install --cask visualstudiocode 装出来的 VSCode 无法从终端用 code 命令调用——因为没启用 CLI 工具。
正确做法分两步:
brew install --cask visualstudiocode sudo xattr -rd com.apple.quarantine /Applications/Visual\ Studio\ Code.app
然后打开一次 VSCode,在菜单栏 Code → Install 'code' command in PATH 点一下。之后才能在终端里用 code . 打开当前目录。
- 跳过
xattr步骤会导致首次启动卡在“已损坏,无法打开”提示 - 如果
code命令仍不可用,检查是否勾选了设置里的Shell Command: Install 'code' command in PATH - 不推荐用
brew install code(那是旧版 CLI 工具包,已弃用)
Windows 上绕过官网下载页,直接命令行静默安装
PowerShell 默认不能直接执行远程脚本,所以不能用 iex (irm ...) 一键拉取安装。稳妥方式是用 winget(Win10 1809+ 自带):
确认 winget 可用:
winget --version
然后执行:
winget install -e --id Microsoft.VisualStudioCode
-
-e表示精确匹配 ID,避免装到第三方打包版 - 默认安装到
%USERPROFILE%\AppData\Local\Programs\Microsoft VS Code,不影响系统级 PATH - 如果提示
Failed to find manifest,先运行winget upgrade --all更新源缓存 - 不建议用
choco install vscode:Chocolatey 版本常滞后 1–2 个正式发布周期
为什么没有真正“一条命令”通用方案? VSCode 不是纯命令行工具,它依赖图形环境、沙箱策略、签名验证和路径注册。所谓“一条命令”,本质是把多步操作封装进包管理器的原子动作里——而每个系统对“安装一个 GUI 应用”的定义不同。
最容易被忽略的一点:
- Linux 上装完
code命令,但没装libnotify或libxkbfile,会导致通知、键盘布局等功能异常,错误日志里只显示GLXBadContext这类模糊报错 - macOS 上未启用 CLI 工具,
code .会报command not found,但很多人以为是安装失败,其实只是 PATH 没生效 - Windows 上用 winget 装完,第一次启动可能黑屏几秒——这是 VSCode 在初始化渲染进程,不是卡死,别急着关掉











