三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

Ubuntu 22.04安装配置VS Code全攻略：APT/Snap/手动安装与高效开发环境搭建

发布时间：2026/8/12 10:17:47 三亩地 编程学习日记
Ubuntu 22.04安装配置VS Code全攻略：APT/Snap/手动安装与高效开发环境搭建

1. 项目概述：为什么在Ubuntu 22.04上安装VS Code是开发者的必修课

如果你刚接触Ubuntu 22.04，或者从其他Linux发行版切换过来，想找一个趁手的代码编辑器，那Visual Studio Code（简称VS Code）几乎是一个绕不开的选择。它早已不是那个简单的“编辑器”，而是一个功能强大的集成开发环境，凭借其轻量、免费、插件生态极其丰富的特点，成为了跨平台开发的“瑞士军刀”。在Ubuntu上，虽然系统自带了gedit，也有像Vim、Emacs这样的神器，但对于大多数追求效率、需要开箱即用体验的开发者来说，VS Code提供了一个完美的平衡点：既有图形界面的直观易用，又能通过终端和插件深度集成Linux的开发环境。

我自己的主力开发机就是Ubuntu 22.04 LTS，从系统安装好那一刻起，配置VS Code就是我的第一个动作。这个过程看似简单，就是“安装”两个字，但里面其实有不少门道。你是直接用Ubuntu Software（软件中心）点击安装？还是通过命令行apt install？又或者去官网下载.deb包手动安装？不同的安装方式，在后续的更新维护、插件兼容性甚至启动速度上，都可能带来细微但重要的差异。更关键的是，安装只是第一步，如何根据你的开发栈（比如Python、JavaScript、Go、C++）配置一个高效、顺手的开发环境，才是真正体现价值的地方。这篇文章，我就结合自己多年的使用经验，为你拆解在Ubuntu 22.04上安装和配置VS Code的最优路径，并分享那些官方文档里不会写的实战技巧和避坑指南。

2. 安装方案全解析：三种方法的利弊与选择

在Ubuntu上安装软件，我们通常有好几条路可以走。对于VS Code，主流的方法有三种：通过Snap包安装、通过APT仓库安装，以及手动下载Deb包安装。每种方法背后都有不同的维护机制和用户体验，选择哪种，取决于你对系统整洁度、更新及时性和控制力的要求。

2.1 方案一：使用Snap包安装（最便捷）

Snap是Canonical公司力推的一种通用软件打包格式，它的最大优点是解决了依赖库的版本冲突问题，每个Snap应用都自带运行时环境，与系统隔离。

安装命令非常简单：

sudo snap install code --classic

这里的--classic参数是关键，它赋予VS Code对系统文件（如你的家目录）的访问权限，这是代码编辑器正常工作所必需的，否则它将无法读写你的项目文件。

这种方式的优点非常明显：

  1. 极度简单：一条命令搞定，几乎不会出错。
  2. 自动更新：Snap服务会自动在后台为你更新VS Code到最新版本，你无需操心。
  3. 环境隔离：所有依赖都打包在Snap内，不会污染你的系统环境，也避免了与其他软件发生库版本冲突。

但它也有不容忽视的缺点，这也是很多资深用户不太喜欢Snap版的原因：

  1. 启动速度慢：由于需要加载独立的运行时环境，Snap版VS Code的启动速度明显慢于原生Deb包安装的版本。第一次启动可能感觉特别明显。
  2. 主题集成不佳：Snap的严格沙盒限制，有时会导致VS Code无法完美应用你的系统全局主题（比如深色模式），图标和窗口装饰可能看起来有点“不协调”。
  3. 文件系统访问限制：虽然用了--classic模式，但在访问某些特殊挂载点或外部驱动器时，可能还是会遇到权限问题，需要额外配置。

注意：如果你追求极致的便捷和系统的纯净，且对一两秒的启动延迟不敏感，那么Snap安装是最省心的选择。它特别适合新手和希望系统维护成本最低的用户。

2.2 方案二：通过微软官方APT仓库安装（推荐）

这是微软官方推荐的方式，也是我个人最常用的方法。它通过将微软的软件源添加到系统的APT源列表中，让你可以像安装其他系统软件一样，用apt命令来安装和管理VS Code。

操作步骤比Snap稍多，但一劳永逸：

  1. 导入微软的GPG公钥，用于验证软件包的签名，确保来源安全。

    sudo apt-get install wget 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/keyrings/packages.microsoft.gpg

  2. 将VS Code的APT仓库源添加到系统。

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

    这个命令创建了一个新的源列表文件vscode.list。注意，这里使用了signed-by参数直接指向我们刚才导入的密钥环，这是一种更现代、更安全的做法。

  3. 更新软件包缓存并安装。

    sudo apt-get update sudo apt-get install code

这个方案的优点在于：

  1. 原生体验：安装的VS Code与系统集成度更高，启动速度快，主题应用完整。
  2. 更新可控：你可以通过标准的sudo apt update && sudo apt upgrade命令来更新VS Code，更新节奏完全由你控制。
  3. 官方支持：由微软直接维护仓库，保证版本的稳定性和安全性。

它的缺点是需要手动添加仓库源，步骤稍显繁琐，但只需做一次。

2.3 方案三：手动下载.deb包安装（最灵活）

你可以直接访问 VS Code官网 ，下载对应64位系统的.deb安装包，然后通过图形界面双击安装，或使用命令行安装。

命令行安装方式如下：

sudo dpkg -i downloaded_package.deb # 如果提示有依赖问题，运行以下命令修复 sudo apt-get install -f

这种方法的适用场景比较特殊：

  1. 离线安装：在没有网络的环境下，你可以提前下载好安装包进行部署。
  2. 安装特定版本：如果你因为兼容性原因，需要回退到某个历史版本，可以从官网的发布历史中找到对应的.deb包。
  3. 完全手动控制：你清楚地知道自己在安装什么，以及从哪里来的。

但它的缺点也很突出：

  1. 无法自动更新：系统不会自动为你更新这个手动安装的包，你需要定期去官网下载新版本并重复安装过程。
  2. 稍显麻烦：对于长期使用的工具，不推荐这种方式，因为维护成本较高。

实操心得：对于绝大多数开发者，我强烈推荐方案二（官方APT仓库）。它在便捷性、系统集成度和可维护性之间取得了最佳平衡。一旦设置好，你就可以享受近乎原生的体验和可控的更新。接下来，我们就以这种方式为基础，展开后续的配置。

3. 安装后的关键配置与核心插件生态搭建

安装完成只是拥有了一个“毛坯房”，要让VS Code变成你的高效开发堡垒，必须进行个性化配置和插件安装。这部分是体现开发者效率差异的关键。

3.1 基础配置调优：让编辑器更顺手

首次启动VS Code后，别急着写代码。先花几分钟调整几个关键设置，能极大提升长期使用的舒适度。

  1. 设置同步（Settings Sync）：如果你在多台设备（比如公司的Ubuntu和家里的macOS）上使用VS Code，一定要登录GitHub或Microsoft账户开启设置同步。它会将你的所有设置、快捷键绑定、已安装的插件列表甚至代码片段都云端同步。换新机器时，登录一下，所有环境瞬间还原，这是VS Code最棒的功能之一。

  2. 访问系统终端：Ubuntu开发离不开终端。在VS Code中，按Ctrl+`可以打开集成终端。默认会使用你的系统默认Shell（比如bash或zsh）。你可以在设置（Ctrl+,）中搜索Terminal > Integrated: Shell Path，将其修改为你喜欢的Shell的绝对路径（例如/usr/bin/zsh）。

  3. 调整自动保存：VS Code默认不会自动保存文件。我建议在设置中搜索Auto Save，将其设置为afterDelay（延迟后保存）或onFocusChange（窗口失去焦点时保存）。这能有效避免因忘记保存而丢失工作成果。同时，可以开启Files: Auto Save Delay，将其设置为一个合理的毫秒数，比如1000（1秒）。

  4. 配置文件编码与换行符：在团队协作中，文件编码（UTF-8）和换行符（LF for Linux/macOS, CRLF for Windows）不一致是常见问题。你可以在设置中设置默认编码和换行符，或者在项目根目录创建.editorconfig文件进行统一规范，VS Code有对应的插件支持。

3.2 插件生态：你的专属武器库

VS Code的强大，一半归功于其海量的插件市场。但插件不是越多越好，装得多反而会拖慢编辑器速度。以下是我认为在Ubuntu上进行通用开发时，几乎必备的几个核心插件，它们构成了效率提升的基石。

核心效率插件：

  • Chinese (Simplified) Language Pack：如果英语不是你的母语，首先安装这个中文语言包，能大幅降低学习成本。
  • GitLens：超级强大的Git增强工具。它直接将代码的作者、最近的提交信息、行级历史等内联显示在编辑器中。查看谁改了哪行代码、为什么改，变得一目了然。这是团队协作和代码审查的神器。
  • EditorConfig for VS Code：帮助你在不同编辑器和IDE之间保持一致的编码风格（缩进、字符集等）。项目里有一个.editorconfig文件，这个插件就能确保所有成员遵守同样的规则。
  • Prettier - Code formatter或Beautify：代码格式化工具。Prettier在JavaScript/TypeScript/前端生态中几乎是标准，支持语言多，风格统一。设置"editor.formatOnSave": true后，每次保存文件都会自动格式化，再也不用为代码风格争论了。

针对特定语言的插件（按需安装）：

  • Python：微软官方出品的Python扩展是必装的。它集成了IntelliSense（智能补全）、linting（代码检查）、调试、单元测试、Jupyter笔记本支持等几乎所有功能。在Ubuntu上，它通常能自动检测到系统安装的Python解释器和虚拟环境。
  • C/C++：同样来自微软的C/C++扩展，提供代码导航、智能感知、调试支持。在Linux上开发C++项目，这个插件配合CMake Tools插件，体验非常好。
  • Java：微软的Extension Pack for Java是一个扩展包，一键安装开发Java所需的大部分工具。
  • Go：Go团队维护的Go扩展，提供了语言服务器、调试、测试等全套功能。
  • Docker：微软的Docker扩展，让你可以直接在VS Code中编写、管理Dockerfile和docker-compose.yml文件，甚至管理镜像和容器，对于现代运维和开发非常方便。

插件管理技巧：

  • 按需启用：有些插件你可能只在特定类型的项目中才需要（比如某个前端框架的辅助工具）。你可以通过VS Code的“扩展”视图，禁用那些暂时不用的插件，只在打开对应项目时再启用，以保持编辑器轻快。
  • 关注性能：如果感觉VS Code变慢了，可以打开命令面板（Ctrl+Shift+P），输入“Show Running Extensions”，查看哪些插件正在运行及其性能影响。

4. 深度集成Ubuntu开发环境

在Ubuntu上使用VS Code，不仅仅是运行一个编辑器，更是要将它深度嵌入到Linux的开发工作流中。

4.1 与系统Shell和工具的集成

VS Code的集成终端是你与Ubuntu系统交互的桥梁。除了基本的Shell访问，你还可以：

  • 分屏终端：在集成终端面板，点击右上角的拆分图标，可以同时打开多个终端会话，一个跑开发服务器，一个运行构建命令，一个执行Git操作，非常高效。
  • 任务系统（Tasks）：VS Code可以将常用的Shell命令（如编译、测试、清理）定义成任务。你可以在项目目录下的.vscode/tasks.json文件中配置。之后，通过Ctrl+Shift+P输入“Run Task”即可执行，无需手动输入长命令。例如，为一个CMake项目配置构建任务：
    { "version": "2.0.0", "tasks": [ { "label": "Build with CMake", "type": "shell", "command": "mkdir -p build && cd build && cmake .. && make -j4", "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$gcc"] } ] }
    配置好后，按Ctrl+Shift+B就能直接执行这个构建链。

4.2 远程开发：释放WSL或远程服务器的潜力

这是VS Code的“杀手级”功能，尤其适合在Ubuntu上工作。如果你在Windows上使用WSL（Windows Subsystem for Linux）的Ubuntu环境，或者需要连接远程的Linux服务器进行开发，你完全不需要在远程端安装完整的VS Code图形界面。

只需在本地VS Code安装“Remote - SSH”或“Remote - WSL”扩展，就可以：

  1. 在本地VS Code窗口中，直接打开远程机器或WSL子系统中的文件夹。
  2. 所有的插件（如语言支持、代码补全）都会在远程端自动运行，而UI交互则留在本地。这意味着你可以在Windows上获得与在Ubuntu桌面原生环境下完全一致的开发体验，并且性能开销极小。
  3. 所有文件操作都在远程，本地不保存代码，既安全又方便。

配置Remote-SSH的基本步骤：

  1. 确保本地与远程服务器可以通过SSH密钥免密登录。
  2. 安装“Remote - SSH”扩展。
  3. 点击左侧活动栏的远程资源管理器图标，配置SSH主机。
  4. 连接后，在新的VS Code窗口中选择远程服务器上的项目目录即可。

这个功能彻底模糊了本地和远程的界限，让你能用自己熟悉的本地环境操作任何远程Linux服务器，对于服务器开发、运维和团队环境统一来说，价值巨大。

4.3 版本控制：Git的图形化最佳伴侣

VS Code内置了非常优秀的Git支持。在Ubuntu上，你需要先确保系统已安装Git（sudo apt install git）。之后，VS Code的源代码管理面板（侧边栏第三个图标）会提供：

  • 直观的变更对比：修改的文件会高亮显示，点击即可看到具体的行级差异。
  • 便捷的暂存与提交：可以轻松地暂存（Stage）特定文件甚至特定代码块（Hunk），然后输入提交信息完成提交。
  • 分支管理：在底部状态栏可以快速切换、创建新分支。
  • 远程仓库操作：可以推送（Push）、拉取（Pull），甚至解决合并冲突也有图形化界面引导。

结合之前提到的GitLens插件，你将拥有一个信息丰富且操作流畅的Git工作流，很多时候甚至不需要再打开独立的Git命令行工具。

5. 性能调优与故障排查实录

即使VS Code以轻量著称，在长期使用、安装大量插件后，也可能遇到性能下降或一些奇怪的问题。以下是我遇到过的典型问题及解决方法。

5.1 常见问题速查表

问题现象可能原因排查与解决方法
启动速度非常慢1. 使用了Snap安装方式。
2. 安装了过多或存在性能问题的插件。
3. 用户设置或工作区设置文件（settings.json）过大或包含错误。		1. 考虑换用APT仓库安装方式。
2. 禁用所有插件，然后逐个启用，找出“元凶”。使用命令面板的“Developer: Show Running Extensions”查看插件性能。
3. 检查~/.config/Code/User/settings.json文件，尝试备份后清空，看是否恢复。
编辑器卡顿、输入延迟1. 特定语言服务器（如Python、Java）占用CPU过高。
2. 文件监视器（File Watcher）过于活跃，例如在node_modules等大型目录中。
3. 硬件加速渲染问题（在部分Linux显卡驱动上）。		1. 打开任务管理器（Ctrl+Shift+P输入“Open Process Explorer”），查看哪个进程CPU占用高。可尝试重启语言服务器或更新对应插件。
2. 在设置中调整Files: WatcherExclude，添加忽略模式，如**/node_modules/**,**/.git/**。
3. 在设置中禁用硬件加速："window.titleBarStyle": "custom"，或尝试启动时加参数--disable-gpu。
插件安装失败或无法加载1. 网络问题，无法访问插件市场。
2. 插件版本与当前VS Code版本不兼容。
3. 插件文件损坏或权限问题。		1. 检查网络，或尝试设置HTTP代理（在设置中搜索Proxy）。
2. 查看插件详情页的兼容性说明，或尝试安装稍旧的版本。
3. 手动删除插件目录（~/.vscode/extensions下的对应文件夹），重新安装。
集成终端无法启动或报错1. 设置的默认Shell路径错误。
2. Shell配置文件（如.bashrc,.zshrc）中存在导致启动失败的语句。		1. 检查设置中的Terminal > Integrated: Shell Path，确保路径有效（如/bin/bash）。
2. 尝试使用-l参数启动一个登录Shell，或在终端设置中暂时将Shell指向/bin/sh进行测试。逐步排查个人配置文件。
中文显示乱码或方框系统缺少中文字体，或编辑器字体设置不支持中文。1. 安装中文字体，如sudo apt install fonts-wqy-zenhei。
2. 在VS Code设置中，将字体族（Editor: Font Family）的首选字体设置为一个包含中文的字体，例如'Droid Sans Mono', 'WenQuanYi Micro Hei Mono', monospace。

5.2 高级排查：用户数据与缓存清理

如果遇到无法定位的诡异问题，可以尝试清理VS Code的用户数据和缓存，这相当于一次“重置”（但会保留你的项目和部分配置，需谨慎）。

  1. 完全关闭VS Code。
  2. 备份重要数据：主要是你的用户设置（~/.config/Code/User/settings.json）、快捷键设置（keybindings.json）和代码片段（snippets/目录）。
  3. 删除缓存和数据目录：
    # 删除缓存 rm -rf ~/.cache/Code # 删除一些可能出问题的运行时数据 rm -rf ~/.config/Code/Cache rm -rf ~/.config/Code/CachedData rm -rf ~/.config/Code/CachedExtensions
  4. 重新启动VS Code。它会重建这些目录。此时你需要重新登录同步账户或手动安装必要的插件。

实操心得：保持插件精简是维持VS Code流畅度的黄金法则。定期回顾已安装的插件，问自己“这个插件我上周用过吗？”。对于不常用的，果断禁用或卸载。另外，善用VS Code内置的性能诊断工具（帮助 -> 打开进程资源管理器、打开开发者工具），它们能提供非常直观的问题线索。

6. 从编辑器到个性化生产中心

经过前面的安装、配置和调优，你的VS Code已经是一个强大的开发工具了。但它的潜力不止于此，通过一些更深度的定制，你可以把它打造成完全符合个人习惯的“生产中心”。

工作区与多项目管理：对于复杂的多仓库项目，可以使用VS Code的“工作区”功能。将多个相关项目的文件夹添加到同一个工作区文件中（.code-workspace），这样你就可以在一个窗口内同时操作它们，共享终端、共享调试配置，管理起来非常高效。

键盘快捷键重塑：VS Code允许你完全自定义所有操作的快捷键。花点时间在“键盘快捷方式”设置里，将你最常用的操作（比如切换侧边栏、分割编辑器、运行特定任务）绑定到最顺手的位置。记住，效率提升往往来自于减少一次鼠标移动。你可以导出你的快捷键配置，方便在其他机器上导入。

代码片段（Snippets）的力量：对于重复性的代码模式（比如创建一个新的React组件、一个Python类定义、一个特定的注释头），不要每次都手动输入。为它们创建代码片段。通过“配置用户代码片段”，你可以定义缩写，输入缩写后按Tab键，就能自动展开成完整的代码块，并可以通过制表位在关键位置快速跳转修改。这是节省时间、减少打字错误的神器。

与系统自动化结合：在Ubuntu上，你可以将VS Code与cron任务、shell脚本结合。例如，写一个脚本，每天定时打开VS Code，拉取指定项目的最新代码，并运行测试套件，将结果通过邮件或通知发送给你。VS Code可以通过命令行参数（如code --folder-uri /path/to/project）被脚本调用，这为自动化开发流程打开了大门。

最后，我想分享一个我自己的小习惯：我为不同的开发场景（比如前端、后端、文档编写）创建了不同的VS Code用户配置配置文件（通过--user-data-dir参数指定不同的目录）。每个配置文件里只安装和启用与该场景最相关的插件和设置。当我切换工作时，就启动对应的配置，这样既能保证环境高度纯净、快速，又能满足不同工作的专业需求。这个技巧在机器性能一般或者项目类型差异很大时特别有用。

编程学习 学习日记 实战经验
← 返回列表