Ubuntu 上安装和使用 Visual Studio Code 完整指南（2025 版）

1. 介绍：为何在 Ubuntu 上使用 VS Code？

Visual Studio Code（以下简称 VS Code）是一款轻量却功能强大的源代码编辑器。由 Microsoft 提供，凭借其开源基座和出色的可扩展性，受到全球开发者的广泛支持。除了 Windows 和 macOS，它还能在基于 Linux 的操作系统上稳定运行。

其中，Ubuntu 是全球使用最广泛的 Linux 发行版之一。它提供官方的长期支持（LTS）版本，具备强大的稳定性和安全性。Ubuntu 免费使用，拥有丰富的软件包生态和强大的社区支持，既适合个人开发，也适合专业使用。

在 Ubuntu 上使用 VS Code 的优势包括：

• 轻量且性能快速：即使在低配机器或云环境中也能流畅运行
• 丰富的扩展生态：轻松添加语言支持、Git 集成、远程开发功能等
• 跨平台一致性：在不同操作系统上拥有相同的用户体验
• 官方支持：Microsoft 提供官方的 Ubuntu 软件包，便于更新管理

本文将按顺序说明实用步骤，从在 Ubuntu 上安装 VS Code、日语本地化、开发环境配置、远程开发到容器使用。无论你是 Ubuntu 新手，还是考虑从其他编辑器迁移，本指南都能帮助你在最短时间内构建完整的 VS Code 环境。

2. 安装方式对比：Snap / APT（Microsoft 仓库） / 官方 DEB

在 Ubuntu 上安装 VS Code 时，主要有三种方式可供选择。比较它们的特性、优缺点，以便选出最适合你的方案。

2-1. Snap（软件中心或 CLI）

特性

• 采用 Snap 格式分发，Ubuntu 的标准包管理系统。
• 可在 Ubuntu 软件中心一键点击安装。
• 在终端中使用 sudo snap install --classic code 进行安装。

优势

• GUI 安装简便，适合初学者。
• 自动更新提升安全性，并确保获取最新功能。

劣势

• 由于沙箱机制，已报告与输入法或主题的兼容性问题。
• 启动和响应速度可能略显慢。

2-2. APT（通过 Microsoft 官方仓库）

特性

• 使用 Microsoft 官方的 APT 仓库，通过 apt 管理 VS Code。
• 通过 .deb 文件注册仓库后，使用 sudo apt update && sudo apt install code 进行管理。

优势

• 与标准 APT 管理集成，实现系统更新的一致性。
• 对日语输入法等核心功能兼容性高。
• 更新控制简洁明了。

劣势

• 初始仓库注册需要额外步骤。
• 对习惯仅使用 GUI 安装的用户来说，可能感觉不够友好。

Linux Software Repository for Microsoft Products

Learn how to install Microsoft products on Linux using the p…

Technically Impossible

Microsoftレポジトリを登録し、Edge、VSCode、PowerShellを”apt install”する。 - Technically Impossible

Ubuntuでのパッケージ・マネジャーと言えば”apt”だが、そのレポジトリでVSCodeは提供されていない。Ubunt…

2-3. 使用官方 DEB 包的独立安装

特性

• 直接从 Microsoft 官方网站下载 .deb 包。
• 使用 sudo apt install ./code_*.deb 安装，自动解决依赖关系。

优势

• 适用于离线或网络受限的环境。
• 初始安装无需注册仓库。

劣势

• 自动更新需要后续手动设置仓库。
• 与 Snap 或 APT 方法相比，长期维护不够便利。

2-4. 应该选择哪种方式？

• 易用性 / 偏 GUI → Snap（Ubuntu 软件中心）
• 稳定性 / 日语输入与可扩展性 → APT（官方仓库）
• 一次性安装 / 最小化配置 → 官方 DEB（独立）

对于日常开发和长期使用，APT（Microsoft 官方）方法提供了最佳的平衡和简单的更新管理。Snap 适合快速测试或试用，而官方 DEB 包则适合受限或验证环境。

基于此比较，下一节将使用“官方 DEB → APT 集成”方法解释推荐的安装程序，并提供具体的命令示例。

3. 程序 A：通过官方 DEB 与 APT 集成安装（推荐）

在本节中，您将使用 Microsoft 推荐的官方 .deb 包 安装 VS Code，同时注册 APT 仓库以确保持续访问最新版本。此方法为日文输入提供了高稳定性，并有助于避免 Snap 版本有时报告的 IME 兼容性问题。

3-1. 从官方网站下载 DEB 包

1. 打开浏览器并访问 官方 Visual Studio Code 下载页面 。
2. 点击 .deb 按钮（适用于 Debian/Ubuntu）以下载包。

3-2. 通过终端安装

如果下载的文件位于 ~/Downloads，则运行以下命令：

cd ~/Downloads
sudo apt install ./code_*.deb

• 直接将 .deb 文件传递给 apt install 会自动解析所需的依赖项。
• 此过程还会 注册 Microsoft 的 APT 仓库 。

3-3. 验证安装

使用以下命令检查已安装的版本：

code --version

或者，在应用程序菜单中搜索“Visual Studio Code”并启动它。

3-4. 更新 VS Code

一旦注册了 APT 仓库，VS Code 将与系统更新一起更新：

sudo apt update
sudo apt upgrade

3-5. 卸载（参考）

如果需要移除 VS Code，请运行：

sudo apt remove code
sudo apt autoremove

通过此设置，您可以以最少的维护继续使用最新版本的 VS Code。

4. 程序 B：使用 Snap 安装（GUI / CLI）

Snap 是 Ubuntu 的标准包分发格式，允许通过软件中心（GUI）或简单的命令行操作进行安装。它特别适合初学者或那些希望快速设置而无需详细配置的人。

4-1. 从软件中心安装（GUI）

1. 从应用程序菜单打开 Ubuntu 软件。
2. 在搜索栏中输入“Visual Studio Code”或“code”。
3. 选择“Visual Studio Code”并点击 安装 按钮。
4. 输入您的密码并等待安装完成。

4-2. 从命令行安装（CLI）

打开终端并输入以下命令：

sudo snap install --classic code

• 需要 --classic 选项来授予标准文件系统访问权限。
• 下载和安装通常在几分钟内完成。

4-3. 验证安装

code --version

或者从应用程序菜单启动“Visual Studio Code”。

4-4. 更新和移除

• Snap 版本会自动更新，因此通常无需手动更新。
• 要移除它，请运行：

  sudo snap remove code
  

4-5. Snap 版本的注意事项

• 日文输入 ：根据环境和 IME 设置，已报告输入问题。切换到 DEB → APT 方法 通常可以解决这些问题。
• 启动速度 ：由于 Snap 的沙箱结构，首次启动可能稍慢。

5. 初始设置：本地化、字体和显示调整

在 Ubuntu 上安装 VS Code 后，第一步应该是 本地化 和 优化可读性。在此阶段的正确配置将使未来的开发更加顺畅。

5-1. 本地化（安装日文语言包）

1. 启动 VS Code 并点击左侧的扩展图标（四方形图标）。
2. 在搜索栏中输入 Japanese Language Pack。
3. 安装 “Japanese Language Pack for Visual Studio Code”。
4. 安装完成后，点击右下角弹出窗口中的 [Change Language]。
5. 重启 VS Code 以应用日语 UI。

如需手动切换，使用 Ctrl+Shift+P（或 F1）打开命令面板，输入 Configure Display Language，并选择 ja。

5-2. 字体设置

对于编程，建议使用等宽字体，并且能够清晰区分全角和半角字符。

1. 打开 [File] → [Preferences] → [Settings]。
2. 在搜索栏中输入 “font family”。
3. 设置您喜欢的字体（例如 Cascadia Code、Fira Code、Noto Sans Mono CJK JP）。

使用 支持连字的字体 可以提升 =>、=== 等符号的可读性。

5-3. 显示调整（主题和图标）

• 主题选择：按 Ctrl+K → Ctrl+T 打开主题选择器。
• 图标主题：使用 Ctrl+Shift+P → File Icon Theme 更改图标集。

5-4. 推荐的其他初始设置

• 显示行号：将 editor.lineNumbers 设置为 on。
• 保存时格式化：启用 editor.formatOnSave。
• 自动保存：将 files.autoSave 设置为 afterDelay。

基本的工作环境已就绪。下一节将介绍必备扩展和配置示例，以进一步提升生产力。

6. 常用扩展与基础配置（前 10 分钟内完成设置）

VS Code 最大的优势之一是能够通过扩展轻松添加功能。本节将介绍在 Ubuntu 上完成初始设置后立即安装的必备扩展，以及显著提升开发效率的基础配置项。

6-1. 必备扩展

1. Japanese Language Pack for Visual Studio Code

• 之前已说明的用于日语 UI 显示的必装扩展。

2. Python

• Python 开发的必备扩展，提供代码检查、自动补全和调试功能。
• 与 Jupyter 扩展结合使用时，还支持 notebook 风格的开发。

3. C/C++

• 为 C 和 C++ 提供代码补全、调试和语法高亮。
• 建议配合 build-essential 包一起使用。

4. GitLens

• 直观显示 Git 历史和差异，对团队开发和变更追踪极为有用。

5. Remote Development Pack

• 一个集成包，可实现通过 SSH、Docker 容器或 WSL 进行远程开发。
• 在远程开发章节中有更详细的说明。

6. Prettier – Code Formatter

• 自动格式化代码，支持 JavaScript、TypeScript、HTML 和 CSS。

6-2. 初始配置项

• 保存时格式化

  "editor.formatOnSave": true
  

这可确保每次保存文件时都保持一致的格式。

• 制表符宽度和缩进

  "editor.tabSize": 4,
  "editor.insertSpaces": true
  

根据团队的编码规范进行调整。

• 在文件末尾插入换行符

  "files.insertFinalNewline": true
  

• 显示行号

  "editor.lineNumbers": "on"
  

• 去除行尾空白

  "files.trimTrailingWhitespace": true
  

6-3. 启用设置同步

使用 VS Code 账户（Microsoft 或 GitHub）登录，并启用 Settings Sync，即可在多台电脑或重新安装后自动同步设置和扩展。

至此，核心开发环境基本完成。

7. 最小化语言特定环境设置

本节说明如何快速为 Python 和 C/C++（在 Ubuntu 上常用）搭建开发环境。将这些配置添加到全新的 VS Code 安装后，即可立即开始实际开发。

7-1. Python 环境设置

1. 安装 Python 和虚拟环境工具

   sudo apt update
   sudo apt install python3 python3-venv python3-pip
   

• python3-venv 为每个项目提供隔离的环境。
• pip 是包管理器。

1. 安装 VS Code 扩展

• 安装官方的 Python 扩展。
• 可选地安装 Jupyter 以支持基于笔记本的工作流。

1. 创建并激活虚拟环境

   python3 -m venv .venv
   source .venv/bin/activate
   

VS Code 会自动检测虚拟环境，并在解释器选择菜单中列出它。

4. Lint 与格式化设置（示例：ruff 和 black）

   pip install ruff black
   

配置 VS Code 在保存时运行 black 进行格式化，运行 ruff 进行静态分析。

7-2. C/C++ 环境设置

1. 安装编译器和必备软件包

   sudo apt update
   sudo apt install build-essential gdb
   

• 包含 gcc、g++ 和 gdb 调试器。

1. 安装 VS Code 扩展

• 安装官方的 C/C++ 扩展。
• 可选地添加 CMake Tools。

1. 配置构建任务

• 打开命令面板（Ctrl+Shift+P），选择 “Tasks: Configure Default Build Task”。
• 选择 g++ build active file。
• 这样即可使用 Ctrl+Shift+B 构建当前文件。

1. 配置调试

• 按 F5 并选择 “C++ (GDB/LLDB)”。
• 将创建 .vscode/launch.json 文件，支持基于断点的调试。

7-3. 验证与测试执行

Python 示例

print("Hello, Python on Ubuntu!")

C++ 示例

#include <iostream>
using namespace std;

int main() {
    cout << "Hello, C++ on Ubuntu!" << endl;
    return 0;
}

保存文件后，使用 Ctrl+Shift+B 构建 C++，并运行生成的可执行文件以验证功能。

8. 远程开发：Remote SSH / Dev Containers / Codespaces

VS Code 不仅支持本地机器上的舒适开发，还支持在 远程服务器 和 容器化环境 上进行开发。在 Ubuntu 上结合这些功能，可显著提升灵活性和可复现性。

8-1. Remote SSH

概述

直接在本地 VS Code 中编辑并执行位于远程服务器上的代码。远程主机上运行的 VS Code 服务器提供类似本地的体验。

步骤

1. 安装 Remote Development Pack（包括 Remote – SSH）。
2. 将连接信息添加到 ~/.ssh/config。示例：

   Host myserver
       HostName 192.168.0.50
       User ubuntu
       IdentityFile ~/.ssh/id_rsa
   

3. 打开命令面板，选择 “Remote-SSH: Connect to Host”，然后选择 myserver。

优势

• 在不直接登录服务器的情况下编辑、运行和调试代码。
• 保持 本地环境 干净，同时 开发 服务器特定的项目。

8-2. Dev Containers

概述

使用 Docker 容器作为 VS Code 开发环境。配置存放在 .devcontainer 目录中，任何人都可以使用相同的设置进行工作。

步骤

1. 在 Ubuntu 上安装 Docker 和 Docker Compose。
2. 安装 Dev Containers 扩展。
3. 在项目根目录创建 .devcontainer/devcontainer.json。示例：

   {
       "name": "Python Dev",
       "image": "python:3.11",
       "features": {},
       "settings": {
           "terminal.integrated.shell.linux": "/bin/bash"
       }
   }
   

4. 在命令面板中选择 “Dev Containers: Reopen in Container”。

优势

• 完全隔离每个项目的依赖和工具链。
• 确保团队成员之间环境的一致性。

8-3. GitHub Codespaces

概述

由 GitHub 提供的基于云的 VS Code 环境。通过浏览器访问，可实现无需本地配置的即时开发。

步骤

1. 打开一个 GitHub 仓库。
2. 选择 “Code” → “Codespaces” → “New codespace”。
3. 几秒钟内，云环境会启动，并在浏览器中打开 VS Code。
4. 可选地从本地 VS Code 进行连接。

优势

• 即使在低配设备上也能进行完整开发。
• 在任何地方都能使用一致的环境工作。

9. 常见问题与故障排除

根据不同的环境和安装方式，在 Ubuntu 上使用 VS Code 时可能会遇到多种问题。本节概述常见问题及其解决方案。

9-1. 日文输入无法工作或不稳定

原因

• Snap 版本的 IME 兼容性问题。
• 沙箱环境中输入法无法正常工作。

解决方案

• 卸载 Snap 版本，改用 官方 DEB（APT 集成） 方法重新安装。
• 如有必要，重新配置 fcitx 或 ibus。

9-2. 启动缓慢或性能差

原因

• Snap 沙箱初始化或大量扩展加载。
• 启用了过多不必要的扩展。

解决方案

• 使用 code --disable-extensions 启动，以定位有问题的扩展。
• 将 Snap 切换为 DEB 通常能提升性能。

9-3. 某些扩展无法工作

原因

• 缺少库或 Ubuntu 版本不兼容。
• 容器或远程环境中的权限问题。

解决方案

• 使用 sudo apt install 安装所需依赖。
• 检查并确认所需路径的访问权限。

9-4. Wayland 下的显示或输入问题

原因

• VS Code 通常通过 XWayland 运行，原生 Wayland 兼容性尚未完全成熟。

解决方案

• 使用 Xorg 会话登录。
• 或者使用以下选项启动：

  code --ozone-platform=x11
  

9-5. 完全卸载

解决方案

• DEB 版本：

  sudo apt remove code
  sudo apt autoremove
  rm -rf ~/.config/Code
  

• Snap 版本：

  sudo snap remove code
  rm -rf ~/.config/Code
  

10. 安全性与更新策略

长期在 Ubuntu 上使用 VS Code，需要保持 安全 与 功能最新。

10-1. 不同安装方式的更新行为

1. APT（官方仓库）

• 通过 sudo apt update && sudo apt upgrade 与系统更新一起应用。
• 在稳定性与新功能之间取得良好平衡。

2. Snap

• 由 snapd 自动更新。
• 更新时机取决于 snapd 的调度。

3. 独立 DEB（无仓库）

• 没有自动更新。
• 需要手动重新安装以获取新版本。

10-2. 安全注意事项

• 使用可信来源
• 始终从官方站点或 Microsoft 仓库下载。
• 避免非官方 PPA 或第三方软件包。
• 扩展选择
• 核实发布者和评论。
• 避免长期未更新的扩展。
• 权限管理
• 严格管理 Remote SSH 与容器的密钥和权限。
• 避免不必要的端口暴露和 Docker 中的 root 容器。

10-3. 推荐的更新频率

• 以稳定性为主：配合 Ubuntu LTS 计划，每几周更新一次。
• 以功能为主：每周检查更新。
• Snap 用户：依赖自动更新，如出现问题可使用 sudo snap revert code 回滚。

11. 总结：快速构建可用的 Ubuntu × VS Code 环境

本文覆盖了安装方式、初始配置、语言环境、远程开发、故障排除与安全性。以下是一份快速搭建的简明路线图。

11-1. 最快的搭建步骤

1. 安装

• 选择 官方 DEB → APT 集成 以获得稳定且易于更新的体验。
• 若想快速试用，可使用 Snap，但需注意可能的 IME 问题。

2. 初始配置

• 安装 Japanese Language Pack 。
• 调整字体和主题。
• 启用保存时自动格式化和行号显示。

1. 必备扩展

• Python、C/C++、GitLens、Remote Development Pack、Prettier。
• 启用 Settings Sync。

1. 语言环境设置

• Python：虚拟环境以及 lint/format 工具。
• C/C++：编译器、调试器、构建和调试任务。

1. 远程开发

• Remote SSH：用于基于服务器的开发。
• Dev Containers：用于项目隔离。
• GitHub Codespaces：用于云端工作流。

1. 安全与更新

• 仅使用官方渠道。
• 通过 APT 或 Snap 定期更新。

11-2. 如何使用本文

• 新的 Ubuntu 用户按照本指南一步步操作，可在一小时内实现 完整的开发环境。
• 从其他编辑器迁移的用户可通过 VS Code 的扩展和远程功能显著提升效率。
• 如遇问题，可参考第 9 章的快速恢复方案。

常见问题

Q1. 我应该使用 Snap 还是 APT 版本？
A. 为了长期稳定，推荐使用 APT 版本（官方 DEB 包）。Snap 适用于短期测试，但可能在输入法行为和启动速度上有所差异。

Q2. 如何启用日语本地化？
A. 安装 “Japanese Language Pack for Visual Studio Code”，然后通过 Configure Display Language 选择 ja，最后重启。

Q3. 日语输入法无法工作。我该怎么办？
A. 若使用 Snap，请切换到官方 DEB 版本。同时检查 ibus 或 fcitx 的配置。

Q4. 开始 Python 开发需要哪些条件？
A. 安装 Python、python3-venv 和 pip，随后在 VS Code 中添加 Python 扩展。

Q5. C/C++ 构建失败。
A. 安装 build-essential 和 gdb，启用 C/C++ 扩展，并配置构建任务。

Q6. 如何使用 Remote SSH？
A. 安装 Remote Development Pack，配置 ~/.ssh/config，然后通过命令面板连接。

Q7. 什么是 Dev Containers？
A. 它们允许使用 Docker 容器作为由 .devcontainer 定义的隔离开发环境。

Q8. 我应该多久更新一次？
A. 为了保持稳定，建议每隔几周更新一次；若想获取新功能，可每周更新。Snap 会自动更新。