正确流程是:先导入微软GPG密钥并添加官方APT源,再执行sudo apt update和sudo apt install code;否则会因源未启用或密钥缺失导致“Unable to locate package code”或“NO_PUBKEY”错误。

Ubuntu/Debian 系统用 apt 安装 VSCode 的正确流程
直接 sudo apt install code 会失败,因为官方仓库默认没启用。必须先加微软的 APT 源和 GPG 密钥,否则 apt 找不到包或校验失败。
执行顺序不能错,漏掉任一环都会导致 E: Unable to locate package code 或 NO_PUBKEY 错误:
- 运行
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg导入密钥 -
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/把密钥放进信任目录 -
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'添加源(注意signed-by路径要和上一步一致) -
sudo apt update刷新索引后,才能sudo apt install code
安装完立刻验证:code --version 应该输出版本号;which code 应该返回 /usr/bin/code。如果命令不可用,说明 PATH 没生效,需检查是否重启了终端或 shell 配置文件。
CentOS/RHEL/Fedora 用 dnf 或 yum 安装时 rpm 包签名验证失败怎么办
直接 sudo dnf install code 同样报错,核心原因是系统没信任微软的 RPM 签名密钥。错误信息通常是 GPG key retrieval failed 或 Public key is not installed。
解决步骤比 Debian 系更紧凑,但顺序同样关键:
- 先下载并导入密钥:
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc - 添加微软仓库:
sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo' - 然后
sudo dnf check-update,再sudo dnf install code
注意:Fedora 36+ 默认用 dnf,RHEL 8+ 也是 dnf;老版 RHEL/CentOS 7 用 yum 命令,但 repo 配置格式一致。如果 dnf search code 查不到结果,大概率是密钥没导入或 repo 文件路径写错。
为什么不用 wget + dpkg/rpm 手动装,而推荐包管理器方式
手动下载 .deb 或 .rpm 包再用 dpkg -i/rpm -ivh 安装,短期能跑起来,但长期维护成本高——每次更新都要重下、重装、手动处理依赖。
包管理器方式的核心优势是自动升级和依赖闭环:
-
sudo apt update && sudo apt upgrade会顺带升级code,无需人工干预 - VSCode 依赖的
libxkbfile1、libasound2等底层库,apt/dnf 会自动拉取匹配版本,避免dpkg -i报dependency is not satisfiable - 卸载干净:
sudo apt remove code会删二进制、配置、缓存三件套;手动装的得自己rm -rf /usr/share/code和清理~/.vscode
唯一例外是离线环境:这时才用 wget 下好 .deb/.rpm,再用 apt install ./code_*.deb(apt 支持本地包依赖解析),比 dpkg -i 更稳。
code 命令在终端里打不开?PATH 和 desktop 文件常被忽略
即使 apt install code 成功,code 命令仍可能提示 command not found。这不是安装失败,而是 PATH 或 desktop 文件没注册到位。
排查重点就两个位置:
-
which code返回空?说明/usr/bin/code没写进 PATH。检查/etc/environment或用户 shell 配置(如~/.bashrc)是否被意外覆盖;临时修复:运行export PATH="/usr/bin:$PATH" -
code .能启动但图形界面不显示?常见于 Wayland 会话下缺少--no-sandbox。可临时加参数启动测试:code --no-sandbox .;长期方案是编辑/usr/share/applications/code.desktop,在Exec=行末尾加上该参数
桌面环境里点图标能启动、终端却不行,90% 是 PATH 问题;反过来,终端能启动但桌面图标灰掉,大概率是 .desktop 文件里 Exec 路径写错了或权限不足。











