LightNode Logo

如何在 Ubuntu 上安装 VS Code

LightNode
LightNode - · 更新于 2026-07-12

快速解答:在 Ubuntu 上安装 VS Code 的最快方法

在 Ubuntu(26.04 LTS、24.04 LTS 或 22.04 LTS)上安装 Visual Studio Code,最快的办法是运行一条 Snap 命令,或者下载官方 .deb 包再用 apt 安装。下面三种方法在当前的 Ubuntu 版本上都行得通:

  1. Snap(一条命令,自动更新):

    sudo snap install code --classic

  2. 官方 .deb 包 —— 从 code.visualstudio.com 下载,然后直接用 apt 安装(这一步还会顺便添加微软的软件源,让 VS Code 随系统一起更新):

    sudo apt install ./code_*_amd64.deb

  3. 微软 APT 软件源(最适合脚本化部署或服务器场景)—— 先添加微软的签名密钥和软件源,再安装 code:

    sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg
echo "deb [arch=amd64,arm64,armhf signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list > /dev/null
sudo apt update && sudo apt install code

装好之后,在终端里输入 code,或从应用程序菜单打开,就能启动 VS Code。下面对每种方法都给出了详细的分步演示,包括纯终端操作说明、安装后的配置以及常见问题排查。

引言

Visual Studio Code(VSCode)是微软开发的一款功能强大、用途广泛且完全免费的源代码编辑器。凭借轻量的体量、丰富的功能和强大的扩展生态,它在开发者中大受欢迎。VSCode 支持大量编程语言和框架,无论是新手还是资深开发者,都能把它用得得心应手。

对 Ubuntu 用户来说,装上 VSCode 就等于打开了代码编辑、调试和版本控制集成的无限可能。无论你是网页开发者、数据科学家,还是系统管理员,VSCode 都能显著提升你的效率,让工作流更加顺畅。

在本指南中,我们会带你一步步在 Ubuntu 上装好 Visual Studio Code。我们会介绍多种安装方法,让你能挑一个既贴合自身需求、又符合你对 Ubuntu 操作系统熟悉程度的方式。

前提条件

在正式进入安装步骤之前,先来确认一下,在 Ubuntu 系统上顺利装好 Visual Studio Code 所需的东西你是否都齐备。前提条件如下:

  1. Ubuntu 操作系统:

    • VSCode 可在所有仍受支持的 Ubuntu 版本上运行,包括 Ubuntu 26.04 LTS(Resolute Raccoon,2026 年 4 月 23 日发布)、24.04 LTS(Noble Numbat)和 22.04 LTS(Jammy Jellyfish),以及当前的非 LTS 版本。Ubuntu 20.04 LTS 仍然可用,但它的标准支持已于 2025 年 5 月 31 日结束,现在只能通过扩展安全维护(Ubuntu Pro)获得更新。
    • Ubuntu 18.04 LTS 已不再受支持。自 VS Code 1.86(2024 年 1 月)起,编辑器要求 glibc 2.28 或更新版本,而 18.04 自带的是 glibc 2.27,因此已无法运行当前的构建版本——1.85 是能在 18.04 上运行的最后一个版本。
    • 在终端里运行 sudo apt update && sudo apt upgrade,确保你的 Ubuntu 系统已是最新。

  2. 网络连接:

    • 下载 VSCode 及其依赖项需要稳定的网络连接。
    • 如果你用的是按流量计费的网络,请留意:当前的 .deb 下载体积约为 190 MB。

  3. 基本的终端知识:

    • 有些安装方法需要用到命令行。
    • 熟悉一些基本的终端命令会很有帮助。

  4. Sudo 权限:

    • 在 Ubuntu 系统上安装软件需要 sudo 权限。
    • 请确保你知道系统的 sudo 密码。

  5. 足够的磁盘空间:

    • 安装完成后,VSCode 大约会占用 400 MB 的磁盘空间。
    • 请确保系统留有足够的可用空间。

  6. 受支持的架构:

    • VSCode 支持 64 位系统。
    • 想查看系统架构,在终端里运行 uname -m,它应当返回 x86_64。

方法一: 从 Ubuntu 软件中心安装 VSCode

Ubuntu 软件中心提供了图形界面来安装应用,对喜欢可视化操作的用户来说是个理想选择。用这种方法安装 Visual Studio Code 的步骤如下:

  1. 打开 Ubuntu 软件中心:

    • 点击 Dock 里的 Ubuntu 软件图标,或在"活动"概览中搜索"Ubuntu 软件"。

  2. 搜索 VSCode:

    • 软件中心打开后,点击顶部的搜索栏。
    • 输入"Visual Studio Code",或直接输入"VSCode",然后按回车。

  3. 找到 Visual Studio Code:

    • 你应该能在搜索结果里看到 Visual Studio Code。
    • 它通常带有官方 VSCode 图标,并标明发布者为微软。

  4. 安装 VSCode:

    • 点击 Visual Studio Code 这一项,打开它的详情页。
    • 点击"安装"按钮。
    • 系统可能会要求你输入密码来授权安装。

  5. 等待安装完成:

    • 软件中心会自动下载并安装 VSCode。
    • 这个过程通常需要几分钟,具体取决于你的网速。

  6. 启动 VSCode:

    • 安装完成后,你可以直接在软件中心点击"启动"按钮。
    • 或者,你也可以在应用程序菜单里找到 VSCode,或在"活动"概览中搜索它。

方法二: 使用 APT 安装 VSCode

用 APT(高级软件包工具)安装 VSCode 是一种更可靠的方式,能确保你直接从微软获取最新版本。这种方法需要把微软的官方软件源添加到你的系统里。具体操作如下:

  1. 更新软件包索引: 打开终端,运行以下命令,确保你的软件包索引已是最新:

    sudo apt update

  2. 安装依赖项: 运行以下命令,安装必要的依赖项:

    sudo apt install wget gpg apt-transport-https

  3. 导入微软 GPG 密钥: 导入微软的 GPG 密钥,并把它存放到现代的 keyrings 目录中。(较旧的 apt-key add 命令已被弃用,在 Ubuntu 22.04 及更新版本上不再可用,所以请改用 gpg --dearmor):

    wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg

  4. 添加 VSCode 软件源: 启用官方 VS Code 软件源,并引用你刚才添加的密钥:

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

  5. 再次更新软件包索引: 添加新软件源后,再更新一次软件包索引:

    sudo apt update

  6. 安装 VSCode: 最后,安装 Visual Studio Code:

    sudo apt install code

  7. 验证安装: 安装完成后,你可以查看版本号来确认是否装好:

    code --version

这种方法有几个好处:

  • 你随时都能用上最新版的 VSCode。
  • 更新会纳入 Ubuntu 的标准更新流程一并管理。
  • 在配置系统的脚本里更容易实现自动化。

方法三: 使用 .deb 包安装 VSCode

用 .deb 包安装 VSCode 是另一种简单直接的方法。如果你想先把安装包下载下来、稍后再装,或者要在没有网络的机器上安装 VSCode,这种方法就很合适。具体操作如下:

  1. 下载 .deb 包:

    • 打开网页浏览器,访问 Visual Studio Code 官方网站: https://code.visualstudio.com/
    • 点击 Linux 版本的下载按钮。
    • 选择适用于 Ubuntu/Debian 的 .deb 包。
    • 下载应该会自动开始。

  2. 找到下载好的文件:

    • 默认情况下,该文件会在你的"下载"文件夹里。
    • 文件名大致形如 code_1.XX.X-XXXXXXXXXX_amd64.deb,其中的 X 代表版本号。

  3. 通过图形界面安装(选项一):

    • 下载完成后,双击这个 .deb 文件。
    • 这会打开 Ubuntu 软件中心。
    • 点击"安装"按钮。
    • 出现授权提示时,输入你的密码。

  4. 通过终端安装(选项二):

    • 如果你更习惯用终端,推荐的做法是用 apt 来安装 .deb 包,它会自动帮你解决所有依赖项: 
      sudo apt install ~/Downloads/code_1.XX.X-XXXXXXXXXX_amd64.deb
    • 请把其中的 X 换成你所下载文件的实际版本号(以当前的 1.128 版为例,文件名形如 code_1.128.0-XXXXXXXXXX_amd64.deb,末尾的一串数字是下载页面上显示的构建时间戳)。这种方式同样会添加微软的软件源,让 VS Code 通过 apt 保持更新。
    • 或者,你也可以先用 dpkg,再修复缺失的依赖项: 
      sudo dpkg -i ~/Downloads/code_1.XX.X-XXXXXXXXXX_amd64.deb
sudo apt install -f

  5. 验证安装:

    • 安装后,你可以从应用程序菜单打开 VSCode,或在终端里运行 code 来确认是否装好。

这种方法也有一些好处:

  • 如果你在另一台机器上下载好 .deb 文件,就能实现离线安装。
  • 你可以自主决定安装哪个版本。
  • 对于组织内的大规模部署非常实用。

方法四: 使用 Snap 安装 VSCode

Snap 包在 Ubuntu 26.04、24.04 和 22.04 上开箱即用,因此这是最快的单命令方案。VS Code 的 snap 包由微软发布和维护,还会在后台自动保持自身更新。使用方法如下:

  1. 用 Snap 安装 VSCode: 打开终端并运行:

    sudo snap install code --classic

    之所以需要加 --classic 参数,是因为 VS Code 要在常规的 snap 沙箱之外编辑文件、运行工具,需要较为宽泛的系统访问权限。

  2. 验证安装: 查看版本号,确认安装成功:

    code --version

这种方法也有一些好处:

  • 只需一条命令,无需配置软件源。
  • 更新会在后台自动完成。
  • 在当前各个 Ubuntu 版本上的表现完全一致。

安装后的操作

在 Ubuntu 系统上成功装好 Visual Studio Code 之后,不妨再做几件事,让使用体验更上一层楼:

  1. 启动 VSCode:

    • 你可以通过多种方式启动 VSCode:
      • 点击应用程序菜单里的 VSCode 图标
      • 在"活动"概览中搜索"Visual Studio Code"
      • 在终端里输入 code 并按回车

  2. 配置命令行集成:

    • VSCode 可以从终端启动,直接打开文件或文件夹。
    • 要启用这项功能,打开 VSCode 后:
      1. 按 Ctrl+Shift+P 打开命令面板
      2. 输入"shell command",然后选择"Shell Command: Install 'code' command in PATH"
    • 之后,你就能用 code . 这类命令,在 VSCode 中打开当前目录了

  3. 安装扩展:

    • VSCode 的功能可以通过扩展来拓展。
    • 安装扩展的方法:
      1. 点击左侧边栏的扩展图标(或按 Ctrl+Shift+X)
      2. 搜索你需要的扩展(例如 Python、C++、JavaScript)
      3. 在想要的扩展上点击"安装"

  4. 调整设置:

    • 按你的喜好来定制 VSCode:
      1. 进入 文件 > 首选项 > 设置(或按 Ctrl+,)
      2. 在这里,你可以调整主题、字号、缩进等各种设置

  5. 更新 VSCode:

    • 如果你是通过 APT 或软件中心安装的:
      • VSCode 会随系统更新自动升级
      • 你也可以运行以下命令手动检查更新: 
        sudo apt update
sudo apt upgrade
    • 如果你是通过 .deb 包安装的:
      • 你需要手动下载并安装新版本
      • 有更新可用时,VSCode 会提示你

  6. 熟悉键盘快捷键:

    • VSCode 有许多好用的键盘快捷键
    • 通过 文件 > 首选项 > 键盘快捷方式 可查看全部快捷键
    • 几个常用的快捷键:
      • Ctrl+P: 快速打开文件
      • Ctrl+Shift+P: 命令面板
      • Ctrl+/: 切换行注释

在 Ubuntu 上安装 VSCode

常见问题解答(FAQ)

问: Visual Studio Code 是免费使用的吗?

答: 是的,Visual Studio Code 是一款免费的开源软件,使用它无需支付任何费用。

问: 我可以用 VSCode 编写非微软出品的语言吗?

答: 当然可以!VSCode 通过其可扩展的体系支持大量编程语言。Python、Java、C++、Ruby 等众多语言,你都能找到对应的扩展。

问: 如果我不再需要 VSCode,如何卸载它?

答: 要卸载 VSCode,你可以在终端里使用以下命令:

sudo apt remove code

如果你当初是通过 .deb 包安装的,可能需要改用:

sudo dpkg -r code

问: VSCode 识别不出我的编程语言,我该怎么办?

答: 你可能需要安装对应的语言扩展。打开 VSCode,进入扩展视图(Ctrl+Shift+X),搜索你所用的语言,找到并安装相关扩展即可。

问: 我可以在多台电脑之间同步 VSCode 设置吗?

答: 可以,VSCode 提供了设置同步功能。点击左下角的齿轮图标,选择"打开设置同步"即可开启。

问: VSCode 多久更新一次?

答: 微软通常每月发布一次 VSCode 更新,内容包括缺陷修复、性能改进和新功能。

问: 我可以用 VSCode 进行远程开发吗?

答: 可以,VSCode 通过其"远程开发"扩展包支持远程开发。借助它,你能把容器、远程主机或 Windows 的 Linux 子系统(WSL)当作功能完备的开发环境来使用。

问: VSCode 和 Visual Studio 是同一个东西吗?

答: 不是。VSCode(Visual Studio Code)和 Visual Studio 并不相同。VSCode 是一款轻量、跨平台的代码编辑器,而 Visual Studio 则是一套主要面向 Windows 的完整集成开发环境(IDE)。

问: 我可以为 VSCode 的开发贡献代码吗?

答: 可以,VSCode 是开源项目,微软也欢迎大家参与贡献。你能在它的 GitHub 仓库里找到源代码和贡献指南。

问: 我的系统托盘里 VSCode 图标不见了,该怎么修复?

答: 这是某些 Linux 发行版上的已知问题。你可以试着安装 `libappindicator1` 软件包:
```
sudo apt install libappindicator1
```
如果这样还不行,你可能需要借助像"TopIcons Plus"这样的 GNOME shell 扩展来显示图标。
LightNode