在 Linux 上安装 Visual Studio Code

1. 下载 .deb 软件包。

2. 使用图形化软件中心安装该软件包，或从命令行安装

   sudo apt install ./<file>.deb
   
   # On older Linux distributions, run these commands instead:
   # sudo dpkg -i <file>.deb
   # sudo apt-get install -f # Install dependencies
   

   注意

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

.deb 软件包会提示安装 apt 软件源和签名密钥，这可以通过系统包管理器启用自动更新。

对于非交互式安装，请在安装 .deb 软件包之前运行以下命令，以自动安装 apt 软件源和签名密钥

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

手动安装 apt 软件源

1. 安装签名密钥

   sudo apt install wget gpg &&
   wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/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 update &&
   sudo apt install code # or code-insiders
   

微软在 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 check-update &&
   sudo dnf install code # or code-insiders
   

   在较旧版本上，请使用 yum

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

VS Code 作为 Snap 软件包官方发布在 Snap Store 中。

使用以下命令安装 Snap 软件包

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

安装后，Snap 守护程序会在后台自动更新 VS Code。每当有新更新可用时，VS Code 都会显示产品内更新通知。

从 官方 Snap 文档了解有关 snap 的更多信息。

RHEL、Fedora 和 CentOS 面板中的 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
   

用于 VS Code 的 Arch 用户软件仓库 (AUR) 软件包由社区维护。

有关安装详情，请参阅 Arch Linux wiki 中关于安装 AUR 软件包的文章。

nixpkgs 软件源中的 VS Code Nix 软件包由社区维护。

使用 Nix 安装 VS Code

1. 在您的 config.nix 中将 allowUnfree 选项设置为 true。

2. 运行以下命令

   nix-env -i vscode
   

当无法通过软件源安装时，手动下载并安装 VS Code .rpm 软件包。除非安装了软件源，否则自动更新将无法生效。

使用您的包管理器安装下载的 .rpm 软件包，例如使用 dnf

sudo dnf install <file>.rpm

当包管理器的列表过时时，安装过程中可能会出现此错误。更新包管理器并重新安装

# For .deb
sudo apt-get update

# For .rpm on Fedora 21 and earlier
sudo yum check-update

# For .rpm on Fedora 22 and later
sudo dnf check-update

某些发行版（例如 Pop!_OS）提供了它们自己的 code 软件包。为确保使用官方的 VS Code 软件源，请创建一个名为 /etc/apt/preferences.d/code 的文件，其内容如下

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

如果在 Debian 上的 VS Code 资源管理器中删除文件失败，则可能是缺少 VS Code 所使用的回收站实现。

运行以下命令安装缺失的软件包

sudo apt-get install gvfs libglib2.0-bin

此通知表明 VS Code 文件监视器的文件句柄耗尽。打开包含许多文件的工作区时，通常会发生这种情况。在调整平台限制之前，请将大型文件夹（例如 Python .venv）添加到 files.watcherExclude 在 VS Code 中打开 在 VS Code Insiders 中打开 设置中。其他正在运行的应用程序也可能会消耗文件句柄，因此关闭其他应用程序可能会有所帮助。

通过运行以下命令查看当前限制

cat /proc/sys/fs/inotify/max_user_watches

通过编辑 /etc/sysctl.conf 并将此行添加到文件末尾，将限制提高到最大值。Arch Linux 和 Ubuntu 24.10 及更高版本使用 /etc/sysctl.d/*.conf 中的文件。

fs.inotify.max_user_watches=524288

加载新值

sudo sysctl --system

每个文件监视占用 1,080 字节。如果耗尽全部 524,288 个监视，上限约为 540 MiB。在内存受限的环境中，请选择较低的值。

另一个选择是使用 files.watcherExclude 在 VS Code 中打开 在 VS Code Insiders 中打开 设置 从 VS Code 文件监视器中排除特定的工作区目录。默认的 files.watcherExclude 在 VS Code 中打开 在 VS Code Insiders 中打开 值排除了 node_modules 以及 .git 下的一些文件夹。请添加 VS Code 不应跟踪的其他目录。

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

打开应用程序菜单，然后选择 文件 > 首选项 > 设置。在 Text Editor > Font 部分中，将 Font Family 设置为 Droid Sans Mono, Droid Sans Fallback。

要直接编辑 settings.json 文件，请设置 editor.fontFamily 在 VS Code 中打开 在 VS Code Insiders 中打开

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

当 VS Code 已在当前目录中打开时，在 Ubuntu 上运行 code . 不会将 VS Code 带到前台。这是可以通过 ccsm 更改的操作系统行为。

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

# Run
ccsm

在 General > General Options > Focus & Raise Behavior 下，将 Focus Prevention Level 设置为 Off。此操作系统设置适用于所有应用程序，而不仅仅是 VS Code。

当 sources.list.d 不存在或当前用户没有权限创建文件时，可能会发生此错误。创建该文件夹和一个空的 vscode.list 文件

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

如果使用 X 转发远程使用 VS Code，请使用原生标题栏来操作窗口。将 window.titleBarStyle 在 VS Code 中打开 在 VS Code Insiders 中打开 设置为 native。

如果出现类似以下内容的错误

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 代替 apt-get，并在提示时接受 origin 更改

sudo apt update