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 种方式）
- 终端直接执行：
- 应用菜单搜索：'Visual Studio Code'
- 桌面快捷方式：安装完成后自动生成，双击即可启动。
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. 设置中文界面
- 启动 VSCode 后，按
Ctrl+Shift+P打开命令面板； - 输入'Configure Display Language'，回车；
- 选择'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 无响应 / 闪退
- 原因：依赖缺失或显卡驱动不兼容。
- 解决方案：
- 修复依赖：
sudo apt install -f -y； - 禁用 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'
- 原因：安装路径未加入系统环境变量。
- 解决方案：
- 检查安装路径：
ls /usr/bin/code（APT 安装应存在）； - 若不存在，重新安装；若存在，添加到 PATH：
- 检查安装路径：
echo "export PATH=\$PATH:/usr/bin" >> ~/.bashrc
source ~/.bashrc
六、总结
| 安装方法 | 优点 | 缺点 |
|---|---|---|
| APT 仓库 | 自动更新、稳定性高、无权限问题 | 需配置仓库（步骤稍多） |
| 手动 DEB | 离线可用、适配内网 | 需手动更新新版本 |
| Snap | 一键安装、无需配置 | 启动慢、沙箱权限限制 |
优先选择APT 仓库安装，兼顾稳定性和可维护性；内网 / 离线环境选手动 DEB；新手图省事可选 Snap。按本文步骤操作，5 分钟即可完成 VSCode 安装并适配中文环境，满足日常开发需求。
