Ubuntu 安装 VSCode 三种方法及常见问题解决

步骤 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。按本文步骤操作，5 分钟即可完成 VSCode 安装并适配中文环境，满足日常开发需求。