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. 设置中文界面
启动 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 安装并适配中文环境，满足日常开发需求。
————————————————
版权声明：本文为CSDN博主「人工智能训练师」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/2501_93651177/article/details/156239278