本站点文档内容均翻译自code.visualstudio.com，仅供个人学习，如有差异请以官网为准。

Linux 上的 Visual Studio Code

安装

  1. 下载并安装适用于您的 Linux 发行版的 Visual Studio Code

    注意

    VS Code 每月发布一次，并支持自动更新，当有新版本发布时。

  2. 安装额外组件

    安装Git、Node.js、TypeScript、语言运行时等。

  3. 从Visual Studio市场安装VS Code扩展

    使用主题、格式化程序、语言扩展和调试器来自定义 VS Code，以适应您喜欢的语言，并且还可以做更多。

  4. 启用AI功能

    小贴士

    如果你还没有 Copilot 订阅，你可以通过注册 Copilot 免费计划 来免费使用 Copilot，并获得每月有限的内联建议和聊天互动。

  5. 开始使用 VS Code 教程

    探索 VS Code 的用户界面和主要功能。

在 Linux 上安装 VS Code

基于Debian和Ubuntu的发行版

  1. 在基于Debian/Ubuntu的发行版上安装Visual Studio Code的最简单方法是下载并安装.deb包（64位），如果可用，可以通过图形化软件中心安装，或者通过命令行安装：

    超级用户权限 软件包管理工具 安装 /输入文件。deb

# 如果你使用的是较旧的 Linux 发行版，你需要运行以下命令：
# sudo dpkg -i <file>.deb
# sudo apt-get install -f # 安装依赖项
    注意

    其他二进制文件也可以在VS Code 下载页面找到。

    当你安装 .deb 包时，它会提示安装 apt 仓库和签名密钥，以通过系统包管理器启用自动更新。

  2. 要自动安装apt仓库和签名密钥，例如在非交互式终端上，首先运行以下命令：

    echo "code code/add-microsoft-repo boolean true" | sudo debconf-set-selections

  3. 手动安装apt仓库：

    1. 运行以下脚本以安装签名密钥：

      超级用户权限 apt-get 安装wget gpg &&
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg &&
超级用户权限 安装 -D -o root -g root -m 644 microsoft.gpg /usr/share/keyrings/microsoft.gpg &&
rm -f microsoft.gpg

    2. 创建一个/etc/apt/sources.list.d/vscode.sources将以下内容保存到文件中，以添加对上游软件包仓库的引用：

      类型: 债务
统一资源标识符: https://packages.microsoft.com/repos/code
套件: 稳定
组件: 主
架构: amd64,arm64,armhf
签署者: /usr/share/keyrings/microsoft.gpg

    3. 最后，更新包缓存并安装包：

      超级用户权限 软件包管理工具 安装 https传输支持 &&
超级用户权限 软件包管理工具 更新 &&
超级用户权限 软件包管理工具 安装 代码 # 或者 code-insiders
注意

由于手动签名过程和我们使用的发布系统，Debian 仓库可能会落后最多三个小时，并且不会立即获得 VS Code 的最新版本。

基于 RHEL、Fedora 和 CentOS 的发行版

我们目前在yum仓库中提供适用于RHEL、Fedora或基于CentOS的系统的稳定64位VS Code。

  1. 通过运行以下脚本安装密钥和yum仓库：

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc &&
echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\nautorefresh=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/yum.repos.d/vscode.repo > /dev/null

  2. 然后更新包缓存并使用安装包地下城与勇士（Fedora 22 及以上版本）：

    dnf 检查更新 &&
超级用户 dnf 安装 代码 # 或 code-insiders

    或者在使用较早版本时yum输入：

    yum 检查更新 &&
超级用户权限 yum 安装 代码 # 或者 code-insiders
注意

由于手动签名过程和我们使用的发布系统，yum源可能会落后最多三个小时，并且不会立即获得最新版本的VS Code。

快照

VS Code 官方在 Snap Store 中以 Snap 包形式分发

从 Snap Store 获取

你可以通过运行以下命令进行安装：

超级用户权限 snap 安装 --经典 代码 # 或者 code-insiders

一旦安装，Snap 守护进程会在后台自动更新 VS Code。每当有新更新可用时，您将在产品中收到更新通知。

注意

如果捕捉 在你的 Linux 发行版中不可用，请查看 安装 snapd 指南，这将帮助你进行设置。

了解更多关于 snaps 的信息，请参阅 官方 Snap 文档。

基于 openSUSE 和 SLE 的发行版

之前提到的yum仓库也适用于基于openSUSE和SLE的系统。

  1. 运行以下脚本安装密钥和yum仓库：

    sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc &&
echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\nautorefresh=1\ntype=rpm-md\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" | sudo tee /etc/zypp/repos.d/vscode.repo > /dev/null

  2. 然后更新包缓存并使用以下命令安装包：

    超级用户权限 zypper 安装 代码

适用于 Arch Linux 的 AUR 软件包

有一个社区维护的Arch User Repository 包用于 VS Code.

要获取有关从 AUR 安装的更多信息，请查阅以下维基条目： 安装 AUR 软件包.

Nix 包用于 NixOS（或任何使用 Nix 包管理器的 Linux 发行版）

有一个社区维护的VS Code Nix 包在 nixpkgs 仓库中。

使用 Nix 安装它：

  1. 设置允许非自由将你的选项设置为真config.nix

  2. 运行以下命令：

    nix-env -i vscode

安装.rpm手动包装

您可以手动下载和安装 VS Code .rpm 包（64 位），但是，除非安装上面的仓库，否则自动更新将无法工作。

一旦下载，.rpm可以通过使用你的包管理器来安装这个包，例如使用地下城与勇士输入：

超级用户权限 dnf 安装 <文件>.rpm
注意

其他二进制文件也可以在VS Code 下载页面找到。

更新

VS Code 每月发布一次，您可以通过查看 发布说明 来了解是否有新版本可用。如果 VS Code 仓库安装正确，那么您的系统包管理器应该像系统上的其他软件包一样自动处理更新。

注意

更新是自动的，并在后台运行Snap 包。

将 VS Code 配置为默认文本编辑器

xdg-open

您可以设置文本文件的默认文本编辑器（文本/纯文本) 被使用xdg-open使用以下命令：

xdg-mime默认 code.desktop text/plain

Debian 替代系统

基于Debian的发行版允许通过使用Debian alternatives系统来设置默认编辑器，而无需担心MIME类型。你可以通过运行以下命令并选择代码输入：

超级用户 更新替代 --设置 编辑器 /usr/bin/code

如果你使用Snap包安装了VS Code，请使用以下命令：

超级用户 更新替代 --设置 编辑器 /snap/bin/code

如果 VS Code 未显示为默认的替代品编辑器你需要注册它：

超级用户权限 更新替代 --安装 /usr/bin/编辑器 编辑器 $(哪个 代码) 10

使用自定义标题栏

自定义标题栏提供了许多好处，包括出色的主题支持和通过键盘导航和屏幕阅读器实现更好的可访问性。这些好处可能并不总是能很好地翻译到Linux平台上。Linux有各种桌面环境和Windows管理器，可能会使VS Code的主题外观对用户来说显得不熟悉。因此，Linux默认情况下不启用自定义标题栏。

对于需要无障碍改进的用户，我们建议在使用屏幕阅读器的无障碍模式下启用自定义标题栏。

您可以手动配置标题栏，使用 Window: 标题栏样式 (

Windows标题栏样式
  • 在 VS Code 中打开
  • 在 VS Code Insiders 中打开
) 设置:

  • 定制使用自定义标题栏。
  • 本地使用操作系统的标题栏。

Windows 作为 Linux 开发者机器

另一种在 Linux 上使用 VS Code 进行开发的选项是使用带有 Windows Subsystem for Linux (WSL) 的 Windows 机器。

适用于 Linux 的 Windows 子系统

通过WSL，您可以在Windows上安装和运行Linux发行版，以在Linux上开发和测试您的源代码，同时仍然在Windows机器上进行本地工作。WSL支持来自Microsoft Store的Linux发行版，如Ubuntu、Debian、SUSE和Alpine。

当与WSL扩展结合使用时，您可以在WSL中运行Linux发行版的上下文中获得完整的VS Code编辑和调试支持。

查看WSL开发文档以了解更多，或者尝试WSL工作入门教程。

下一步

一旦你安装了 VS Code，这些主题将帮助你了解更多有关它的信息：

  • VS Code 教程 - 一个快速的实践之旅，介绍 VS Code 的主要功能。
  • 小贴士和技巧 - 为使用 VS Code 工作的生产力小贴士合集。
  • AI辅助编码 - 了解如何在VS Code中使用GitHub Copilot来帮助你更快地编写代码。

常见问题

Debian 和将文件移入回收站

如果你在从 VS Code Explorer 中删除文件时在 Debian 操作系统上看到错误，那可能是因为 VS Code 所使用的垃圾回收实现不存在。

运行以下命令来解决此问题：

超级用户 软件包管理工具 安装 文件系统虚拟 GLib 库工具

与其他仓库的 VS Code 包发生冲突

一些发行版，例如 Pop!_OS 提供他们自己的 代码包。为了确保使用官方 VS Code 仓库，请创建一个名为/etc/apt/preferences.d/code包含以下内容：

包: code
固定: origin "packages.microsoft.com"
固定优先级: 9999

“Visual Studio Code 无法监视此大型工作区中的文件更改”（错误 ENOSPC）

当您看到此通知时，表示 VS Code 文件监视器由于需要实现文件监视而耗尽了文件句柄。最常见的情况是在打开包含许多文件的大型工作区时发生。在调整平台限制之前，请确保潜在的大文件夹，例如 Python.venv，添加到

文件观察者排除
  • 在 VS Code 中打开
  • 在 VS Code Insiders 中打开
设置（更多细节如下）。还有一种可能是一些正在运行的应用程序消耗了大量文件句柄，导致VS Code没有可用的句柄。在这种情况下，关闭这些其他应用程序可能会有所帮助。

当前限制可以通过运行查看：

猫 /proc/sys/fs/inotify/max_user_watches

通过编辑可以将其限制增加到最大值/etc/sysctl.conf（在 Arch Linux 和 Ubuntu 24.10 及更高版本上除外，见下文）并在此文件末尾添加这一行：

fs.inotify.max_user_watches=524288

然后可以通过运行来加载新值请将以下文本翻译成中文: sudo sysctl -p输入：.

虽然524,288是最大可以监控的文件数量，如果你的环境特别内存受限，你可能需要降低这个数字。每个文件监控占用1,080字节，所以假设所有524,288个监控都被使用，那么结果是一个大约540 MiB的上限。

Arch-基于的发行版（包括Manjaro）和基于Ubuntu的发行版从24.10开始需要你更改不同的文件；请按照这些步骤进行操作。

另一个选项是通过 将特定的workspace目录从VS Code文件监视器中排除。

文件观察者排除
  • 在 VS Code 中打开
  • 在 VS Code Insiders 中打开
设置。默认值为
文件观察者排除
  • 在 VS Code 中打开
  • 在 VS Code Insiders 中打开
排除节点模块和一些文件夹在.git，但您可以添加其他目录，不希望 VS Code 跟踪。

"files.watcherExclude": {
    "**/.git/objects/**": true,
    "**/.git/subtree-cache/**": true,
    "**/node_modules/*/**": true
  }

我看不到 Ubuntu 中的中文字符

我们正在修复这个问题。与此同时，请打开应用程序菜单，然后选择 文件 > 首选项 > 设置。在 文本编辑器 > 字体 部分，将“字体系列”设置为 Droid Sans Mono, Droid Sans Fallback如果你更喜欢编辑settings.json直接文件，设置

编辑器字体家族
  • 在 VS Code 中打开
  • 在 VS Code Insiders 中打开
如图所示：

    "editor.fontFamily"："Droid Sans Mono, Droid Sans Fallback"

包git未安装

此错误可能在安装过程中出现，通常是由于包管理器的列表过时。尝试更新它们并重新安装：

# 适用于 .deb
超级用户权限 软件包管理工具 更新

# 对于 .rpm (Fedora 21 及以下版本)
超级用户权限 yum 检查更新

# 对于 .rpm (Fedora 22 及以上版本)
sudo dnf check-update

在 Ubuntu 上，bin 命令的代码不会将Windows带到前台。

跑步代码在 Ubuntu 系统中，当 VS Code 已经在当前目录中打开时，不会将 VS Code 带到前台。这是操作系统的一个功能，可以使用以下方法禁用：ccsm输入：.

# 安装
超级用户权限 apt-get 更新
超级用户权限 apt-get 安装 compizconfig-settings-manager

# 运行
ccsm

在常规 > 常规选项 > 聚焦与提升行为中，将“聚焦预防级别”设置为“关闭”。请记住，这是一个操作系统级别的设置，将适用于所有应用程序，而不仅仅是 VS Code。

无法安装 .deb 包，因为 “/etc/apt/sources.list.d/vscode.list: 没有这样的文件或目录”

这可能会发生在sources.list.d不存在或您没有权限创建文件。要解决此问题，请尝试手动创建文件夹和一个空的vscode.列表文件:

超级用户权限 创建目录 /etc/apt/sources.list.d
超级用户权限 创建空文件 /etc/apt/sources.list.d/vscode.list

在通过X转发远程Windows时，无法移动或调整Windows大小

如果您使用 X 转发远程使用 VS Code，您需要使用原生标题栏以确保可以正确地操作Windows。您可以通过设置切换到使用它。

Windows标题栏样式
  • 在 VS Code 中打开
  • 在 VS Code Insiders 中打开
至本地输入：.

仓库更改了其原始值

如果你收到类似于以下的错误：

E: 仓库 '...' 改变了其 'Origin' 值，从 '...' 变为 '...'
N: 在可以应用此仓库的更新之前，必须明确接受。请参阅 apt-secure(8) 手册页了解详细信息。

使用公寓而不是apt-get并提示您接受来源更改：

超级用户权限 软件包管理工具 更新