Ubuntu 系统安装 VSCode 超全指南（3 种方法，适配 20.04/22.04 LTS）

VSCode（Visual Studio Code）是 Ubuntu 下最常用的轻量级代码编辑器，支持全语言开发、插件扩展和跨平台同步。本文提供 3 种安装方法（APT 仓库 / 手动 DEB/Snap），其中APT 仓库安装是首选（自动更新、稳定性最高），适配所有主流 Ubuntu 版本（20.04/22.04 LTS），附高频问题解决方案。

一、方法 1：通过官方 APT 仓库安装（推荐，自动更新）

此方法安装的 VSCode 会随系统 APT 更新自动升级，无需手动下载新版本，是最省心的方案。

步骤 1：安装依赖（解决密钥导入 / 仓库配置依赖）

sudo apt update

sudo apt install -y wget gpg apt-transport-https software-properties-common

步骤 2：导入微软官方 GPG 密钥（避免安装时签名验证失败）

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg

sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/packages.microsoft.gpg

步骤 3：添加 VSCode 官方 APT 仓库

echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list > /dev/null

步骤 4：更新源并安装 VSCode

sudo apt update

sudo apt install -y code

步骤 5：启动 VSCode（3 种方式）

• 终端直接执行：

code

• 应用菜单搜索："Visual Studio Code"
• 桌面快捷方式：安装完成后自动生成，双击即可启动。

二、方法 2：手动下载 DEB 包安装（适配网络受限场景）

若无法访问微软仓库，可手动下载 deb 包安装，适合离线 / 内网环境。

步骤 1：下载 VSCode deb 包（适配 AMD64 架构，Ubuntu 主流架构）

wget https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64 -O vscode_latest.deb

（若 wget 下载慢，可直接访问VSCode 官网手动下载 deb 包，传到 Ubuntu 系统）

步骤 2：安装 deb 包

sudo dpkg -i vscode_latest.deb

步骤 3：修复依赖缺失（若安装时报 "依赖未满足"）

sudo apt install -f -y

三、方法 3：通过 Snap 安装（最简单，一键搞定）

Snap 是 Ubuntu 内置的包管理器，安装 VSCode 无需配置仓库，一键完成（缺点：启动速度略慢）。

sudo snap install code --classic

四、安装后必做：优化 VSCode 体验

1. 设置中文界面

1. 启动 VSCode 后，按Ctrl+Shift+P打开命令面板；
2. 输入 "Configure Display Language"，回车；
3. 选择 "zh-CN"，重启 VSCode 即可生效（若提示安装中文语言包，点击 "Install" 即可）。

2. 安装常用插件（按需选择）

• 中文语言包：Chinese (Simplified) Language Pack
• 代码补全：Tabnine / Kite
• 终端集成：Terminal
• 版本控制：GitLens
• 语法高亮：对应编程语言插件（如 Python/Java/Go）

五、高频问题及解决方案

问题 1：安装时报 "GPG verification failed"（GPG 验证失败）

• 原因：微软 GPG 密钥未正确导入。
• 解决方案：重新执行步骤 2 的密钥导入命令，或手动删除旧密钥后重试：

sudo rm /etc/apt/trusted.gpg.d/packages.microsoft.gpg

再重新导入密钥：

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/packages.microsoft.gpg > /dev/null

问题 2：启动 VSCode 无响应 / 闪退

• 原因：依赖缺失或显卡驱动不兼容。
• 解决方案：
  1. 修复依赖：sudo apt install -f -y；
  2. 禁用 GPU 加速启动（适合老显卡 / 集显）：

code --disable-gpu

• 若仍闪退，卸载后重新通过 APT 仓库安装：

• sudo apt remove -y code && sudo apt autoremove -y

  再重新执行方法 1 的安装步骤。

问题 3：Snap 安装的 VSCode 无法访问本地文件

• 原因：Snap 包的沙箱权限限制。
• 解决方案：

sudo snap connect code:home :home

（授予 VSCode 访问用户主目录的权限）

问题 4：终端输入code提示 "command not found"

• 原因：安装路径未加入系统环境变量。
• 解决方案：
  1. 检查安装路径：ls /usr/bin/code（APT 安装应存在）；
  2. 若不存在，重新安装；若存在，添加到 PATH：

echo "export PATH=\$PATH:/usr/bin" >> ~/.bashrc

• source ~/.bashrc

六、总结

安装方法	优点	缺点
APT 仓库	自动更新、稳定性高、无权限问题	需配置仓库（步骤稍多）
手动 DEB	离线可用、适配内网	需手动更新新版本
Snap	一键安装、无需配置	启动慢、沙箱权限限制

优先选择APT 仓库安装 ，兼顾稳定性和可维护性；内网 / 离线环境选手动 DEB；新手图省事可选 Snap。按本文步骤操作，5 分钟即可完成 VSCode 安装并适配中文环境，满足日常开发需求。