Linux 上的 Visual Studio Code

安装

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

    注释

    VS Code 每月发布版本，并在新版本发布时支持自动更新。

  2. 安装额外组件

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

  3. 从 Visual Studio Marketplace 安装 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位），如果有图形软件中心，也可以通过命令行安装：

    sudo apt install ./<file>.deb

# If you're on an older Linux distribution, you will need to run this instead:
# sudo dpkg -i <file>.deb
# sudo apt-get install -f # Install dependencies
    注释

    其他二进制文件也可在VS Code下载页面获取。

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

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

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

  3. 要手动安装apt仓库：

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

      sudo apt-get install wget gpg &&
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg &&
sudo install -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文件中包含以下内容，以添加对上游包仓库的引用：

      Types: deb
URIs: https://packages.microsoft.com/repos/code
Suites: stable
Components: main
Architectures: amd64,arm64,armhf
Signed-By: /usr/share/keyrings/microsoft.gpg

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

      sudo apt install apt-transport-https &&
sudo apt update &&
sudo apt install code # or code-insiders
注释

由于手动签名流程和我们使用的发布系统，Debian 仓库可能会延迟多达三小时，且无法立即获得最新版本的 VS Code。

基于RHEL、Fedora和CentOS的发行版

我们目前在一个 yum 仓库中发布了稳定的 64 位 VS Code，适用于基于 RHEL、Fedora 或 CentOS 的发行版。

  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. 然后更新包缓存并用以下方式安装包DNF（Fedora 22及以上）：

    dnf check-update &&
sudo dnf install code # or code-insiders

    或者在旧版本中使用好吃:

    yum check-update &&
sudo yum install code # or code-insiders
注释

由于手动签名流程和我们使用的发布系统，yum repo 可能会延迟最多三小时，且无法立即获得最新版本的 VS Code。

啪

VS Code 作为 Snap 包正式在 Snap 商店中分发

去Snap商店买

你可以通过运行以下程序来安装：

sudo snap install --classic code # or code-insiders

安装后，Snap守护进程会自动在后台更新VS Code。每当有新更新可用时，你都会收到产品内的更新通知。

注释

如果啪你的Linux发行版里没有，可以看看安装snapd指南，这能帮你设置。

想了解更多关于Snap的信息，请访问官方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. 然后更新包缓存并用以下方法安装包：

    sudo zypper install code

Arch Linux 的 AUR 包

有一个由社区维护的 VS Code Arch 用户仓库包。

如需获取AUR安装的更多信息，请参阅以下维基条目：安装AUR套件。

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

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

使用 Nix 安装：

  1. 赛场allowUnfree在你的config.nix

  2. 执行以下命令：

    nix-env -i vscode

安装.rpm手动打包

你可以手动下载并安装VS Code .rpm包（64位），但如果没有安装上述仓库，自动更新是无法实现的。

一旦下载，.rpm可以通过使用包管理器安装包，例如：DNF:

sudo dnf install <file>.rpm
注释

其他二进制文件也可在VS Code下载页面获取。

更新

VS Code 每月发售，你可以通过查看发布说明来查看新版本。如果 VS Code 仓库安装正确，那么你的系统包管理器应该会像系统上的其他包一样处理自动更新。

注释

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

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

XDG-Open

你可以设置文本文件的默认文本编辑器（文本/纯文字） 的XDG-Open命令如下：

xdg-mime default code.desktop text/plain

Debian 替代方案系统

基于 Debian 的发行版允许通过使用 Debian 替代方案系统设置默认编辑器，无需担心 MIME 类型。您可以通过执行以下命令并选择代码:

sudo update-alternatives --set editor /usr/bin/code

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

sudo update-alternatives --set editor /snap/bin/code

如果VS Code没有作为默认的替代方案出现编辑，你需要注册它：

sudo update-alternatives --install /usr/bin/editor editor $(which code) 10

使用自定义标题栏

自定义标题栏带来了许多好处，包括出色的主题支持以及通过键盘导航和屏幕阅读器更便捷的可访问性。这些优势在Linux平台上可能并不总是同样适用。Linux有各种桌面环境和窗口管理器，可能会让VS Code主题对用户显得陌生。因此，Linux默认不启用自定义标题栏。

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

你可以手动配置标题栏，使用窗口：标题栏样式 (

window.titleBarStyle
  • 在VS代码中打开
  • 在VS Code Insiders中开放
） 设定：

  • 习俗：使用自定义标题栏。
  • 本地：使用作系统的标题栏。

Windows作为Linux开发者机器

另一种使用 VS Code 进行 Linux 开发的选择是使用带有 Windows 子系统 Linux （WSL）的 Windows 机器。

Linux 的 Windows 子系统

通过 WSL，你可以在 Windows 上安装和运行 Linux 发行版，在本地 Windows 机器上开发和测试源代码。WSL 支持如 Ubuntu、Debian、SUSE 和 Alpine 等 Linux 发行版，这些发行版可在 Microsoft Store 购买。

结合WSL扩展，你可以在Linux发行版的WSL环境中运行时，获得完整的VS代码编辑和调试支持。

想了解更多，请参阅《在WSL中开发》文档，或者尝试《在WSL中工作》入门教程。

下一步

安装 VS Code 后，以下内容将帮助你更好地了解它：

  • VS Code 教程——快速上手 VS Code 的关键功能导览。
  • 技巧与窍门——一系列关于使用 VS Code 的生产力技巧。
  • AI辅助编码——学习如何在VS Code中使用GitHub Copilot，帮助你更快写代码。

常见问题

Debian 和将文件移入垃圾桶

如果你在 Debian作系统的 VS Code 资源管理器中删除文件时看到错误，可能是因为 VS Code 使用的垃圾实现不存在。

请执行以下命令来解决这个问题：

sudo apt-get install gvfs libglib2.0-bin

与其他仓库的 VS Code 包冲突

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

Package: code
Pin: origin "packages.microsoft.com"
Pin-Priority: 9999

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

当你看到这个通知时，说明 VS Code 文件监视器正在用尽实现文件监视所需的文件句柄。通常情况下，打开一个体积大且包含大量文件的工作区时，这种情况会发生。在调整平台限制之前，确保可能存在较大的文件夹，比如 Python.venv，被添加到

files.watcherExclude
  • 在VS代码中打开
  • 在VS Code Insiders中开放
背景设定（详情见下文）。也有可能其他正在运行的应用程序消耗了太多文件句柄，导致 VS Code 没有剩余的句柄。在这种情况下，关闭这些其他申请可能会有帮助。

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

cat /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是可观看的最大文件数量，但如果你身处内存特别有限的环境，可能需要降低这个数字。每个文件守望占用1080字节，假设全部524288个手表都被消耗，则最大值约为540 MiB。

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

另一种选择是通过

files.watcherExclude
  • 在VS代码中打开
  • 在VS Code Insiders中开放
环境。默认
files.watcherExclude
  • 在VS代码中打开
  • 在VS Code Insiders中开放
排除node_modules以及以下的一些文件夹.git但你可以添加其他目录，这些目录你不想让 VS Code 跟踪。

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

我在Ubuntu里看不到中文字符

我们正在努力修复。同时，打开应用菜单，然后选择“设置”>偏好设置> 文件“。在文本编辑器>字体部分，设置“字体家族”为无单一机器人，无备份机器人.如果你想编辑settings.json直接文件，设置

editor.fontFamily
  • 在VS代码中打开
  • 在VS Code Insiders中开放
如图所示：

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

套件 git 未安装

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

# For .deb
sudo apt-get update

# For .rpm (Fedora 21 and below)
sudo yum check-update

# For .rpm (Fedora 22 and above)
sudo dnf check-update

Ubuntu 上的代码箱命令不会把窗口带到前景

跑步代码。在Ubuntu上，当当前目录中已经打开VS Code时，VS Code不会被带到前景。这是作系统的一个功能，可以通过以下方式禁用CCSM.

# Install
sudo apt-get update
sudo apt-get install compizconfig-settings-manager

# Run
ccsm

在“一般>一般选项>专注与提升行为”中，将“注意力预防级别”设置为“关闭”。记住这是一个作系统层面的设置，适用于所有应用程序，而不仅仅是VS Code。

由于“/etc/apt/sources.list.d/vscode.list： no such file or directory” 无法安装.deb包

这种情况可能发生在来源列表不存在，或者你没有权限创建该文件。要解决这个问题，可以尝试手动创建文件夹和一个空的vscode.list文件：

sudo mkdir /etc/apt/sources.list.d
sudo touch /etc/apt/sources.list.d/vscode.list

在X转发远程窗口时，无法移动或调整窗口大小

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

window.titleBarStyle
  • 在VS代码中打开
  • 在VS Code Insiders中开放
到本地.

仓库更改了其起源值

如果您收到类似以下错误：

E: Repository '...' changed its 'Origin' value from '...' to '...'
N: This must be accepted explicitly before updates for this repository can be applied. See apt-secure(8) manpage for details.

用途公寓代替APT-GET并且系统会提示你接受起源变更：

sudo apt update