1. 先选择适合自己的 VSCode 版本#

在 Arch Linux 上使用 VSCode，常见选择主要有三类。

如果你只是想快速开始，推荐直接安装 Arch 官方仓库里的 code。如果你需要使用微软官方 Marketplace 中的某些扩展，例如部分远程开发、同步或专有扩展，那么可以考虑安装 AUR 中的 visual-studio-code-bin。

1
sudo pacman -S code

如果你使用 AUR 助手，也可以安装微软官方版本：

1
yay -S visual-studio-code-bin

安装完成后，在终端输入：

1
code

如果 VSCode 能正常打开，说明基础安装已经完成。

2. 建议先做的基础系统准备#

VSCode 本身只是编辑器，真正影响开发体验的还有字体、语言环境、Git、终端 Shell、构建工具链等基础组件。

可以先安装一些常用工具：

1
sudo pacman -S git base-devel openssh ripgrep fd nodejs pnpm

这些工具分别对应：

• git：版本管理；
• base-devel：编译 AUR 软件和本地依赖时常用；
• openssh：远程仓库、服务器连接；
• ripgrep：更快的全文搜索，很多编辑器工具也会调用它；
• fd：更好用的文件查找工具；
• nodejs、pnpm：前端、Astro、Svelte、Vite 等项目常用环境。

如果你主要写 Python，可以继续安装：

1
sudo pacman -S python python-pip python-virtualenv

如果你主要写 Rust：

1
sudo pacman -S rustup
2
rustup default stable

3. 配置中文、字体和编辑体验#

VSCode 在 Arch Linux 上默认可以正常显示中文，但为了让界面和代码更舒服，建议安装中文字体和等宽字体。

1
sudo pacman -S noto-fonts noto-fonts-cjk noto-fonts-emoji

如果你喜欢更适合编程的字体，可以安装 JetBrains Mono：

1
sudo pacman -S ttf-jetbrains-mono

然后在 VSCode 的 settings.json 中写入：

1
{
2
  "editor.fontFamily": "JetBrains Mono, Noto Sans Mono CJK SC, monospace",
3
  "editor.fontSize": 15,
4
  "editor.lineHeight": 1.7,
5
  "editor.fontLigatures": true,
6
  "terminal.integrated.fontFamily": "JetBrains Mono, Noto Sans Mono CJK SC, monospace"
7
}

如果你更喜欢稳定朴素的显示效果，也可以把 editor.fontLigatures 设为 false。

4. 集成终端：让 VSCode 更像开发工作台#

Arch 用户通常会自定义 Shell，例如 Bash、Zsh 或 Fish。VSCode 的集成终端可以直接指定默认配置。

以 Zsh 为例：

1
sudo pacman -S zsh
2
chsh -s /bin/zsh

然后在 VSCode 配置中指定默认终端：

1
{
2
  "terminal.integrated.defaultProfile.linux": "zsh",
3
  "terminal.integrated.profiles.linux": {
4
    "zsh": {
5
      "path": "/bin/zsh"
6
    },
7
    "bash": {
8
      "path": "/bin/bash"
9
    }
10
  }
11
}

如果你使用 Fish，可以改成：

1
{
2
  "terminal.integrated.defaultProfile.linux": "fish",
3
  "terminal.integrated.profiles.linux": {
4
    "fish": {
5
      "path": "/usr/bin/fish"
6
    }
7
  }
8
}

这样做的好处是：打开项目后，编辑、运行命令、查看 Git 状态、启动开发服务器都可以在一个窗口中完成。

5. Wayland 环境下的 VSCode 设置#

如果你使用 KDE Plasma Wayland、GNOME Wayland、Hyprland、Sway 等环境，可能希望让 Electron 应用使用更原生的 Wayland 支持。

对于 Code / VSCode，可以创建：

1
mkdir -p ~/.config
2
echo "--enable-features=UseOzonePlatform --ozone-platform=wayland" > ~/.config/code-flags.conf

对于 VSCodium：

1
mkdir -p ~/.config
2
echo "--enable-features=UseOzonePlatform --ozone-platform=wayland" > ~/.config/codium-flags.conf

如果启用后遇到窗口闪烁、输入法异常或缩放问题，可以先删除对应 flags 文件，回退到默认 XWayland 模式：

1
rm ~/.config/code-flags.conf

Wayland 生态更新很快，不同显卡、桌面环境和 Electron 版本的表现可能不同。遇到问题时，不要盲目怀疑 VSCode 本身，先确认是否与 Wayland flags、输入法或显卡驱动有关。

6. 推荐的通用 VSCode 设置#

下面是一份适合日常开发的基础配置，可以按需复制到用户配置中。

1
{
2
  "editor.tabSize": 2,
3
  "editor.insertSpaces": true,
4
  "editor.formatOnSave": true,
5
  "editor.wordWrap": "on",
6
  "editor.minimap.enabled": false,
7
  "editor.renderWhitespace": "boundary",
8
  "files.autoSave": "onFocusChange",
9
  "files.trimTrailingWhitespace": true,
10
  "files.insertFinalNewline": true,
11
  "workbench.startupEditor": "none",
12
  "explorer.confirmDelete": false,
13
  "git.autofetch": true,
14
  "git.confirmSync": false,
15
  "terminal.integrated.scrollback": 10000
16
}

这份配置的目标不是“功能越多越好”，而是减少干扰、提高可读性，并让格式化和文件保存更符合开发习惯。

需要注意的是，formatOnSave 依赖具体语言的格式化器。如果一个项目已经配置了 Biome、Prettier、ESLint、Black、Ruff 或 rustfmt，最好优先遵守项目自己的配置。

7. 常用扩展推荐#

VSCode 的强大很大程度来自扩展，但扩展不是越多越好。建议按语言和项目类型安装。

8. 项目级配置优先于个人习惯#

一个常见问题是：自己的 VSCode 配置和项目配置冲突。

比如你个人喜欢 2 空格缩进，但项目要求 4 空格；你喜欢 Prettier，但项目使用 Biome；你喜欢自动保存，但项目生成文件很多，自动保存可能触发频繁构建。

更推荐的做法是：

• 个人通用偏好放在 User Settings；
• 项目强约束放在 .vscode/settings.json；
• 团队共享的格式规则放在项目配置文件中，例如 .editorconfig、biome.json、.prettierrc、pyproject.toml、rustfmt.toml。

示例项目级配置：

1
{
2
  "editor.defaultFormatter": "biomejs.biome",
3
  "editor.formatOnSave": true,
4
  "typescript.tsdk": "node_modules/typescript/lib"
5
}

这样可以减少“我这里格式化后怎么全变了”的问题。

9. 性能优化：少装扩展，按项目启用#

Arch Linux 上的软件版本通常比较新，VSCode 也更新频繁。大多数性能问题并不是 VSCode 本体造成的，而是扩展过多、文件监听范围过大、项目依赖目录太庞大。

可以从这几个方向优化：

1
{
2
  "search.exclude": {
3
    "**/node_modules": true,
4
    "**/.git": true,
5
    "**/dist": true,
6
    "**/.astro": true,
7
    "**/.next": true,
8
    "**/target": true
9
  },
10
  "files.watcherExclude": {
11
    "**/node_modules/**": true,
12
    "**/.git/**": true,
13
    "**/dist/**": true,
14
    "**/target/**": true
15
  }
16
}

1
Developer: Show Running Extensions

10. 常见问题排查#

1
ssh -T git@github.com

1
ssh-keygen -t ed25519 -C "your_email@example.com"

1
sudo pacman -S fcitx5 fcitx5-configtool fcitx5-chinese-addons

1
code --disable-extensions

11. 我的建议：把 VSCode 当成“可组合工具箱”#

在 Arch Linux 上使用 VSCode，不需要追求一次性配置到完美。更好的方式是：

1. 先安装能用的版本；
2. 配好字体、终端和 Git；
3. 只安装当前项目需要的扩展；
4. 把项目规则交给项目配置文件；
5. 遇到问题时用最小化方式排查。

Arch Linux 的自由度很高，VSCode 的可定制性也很强。二者结合的关键不是堆满插件和配置，而是让编辑器贴合自己的工作流：打开快、搜索快、终端顺手、格式化稳定、扩展够用，并且出了问题知道从哪里排查。

总结#

Arch Linux + VSCode 是一套非常适合个人开发者的组合。Arch 提供新鲜、可控、透明的软件环境，VSCode 提供成熟的编辑器体验和庞大的插件生态。

如果你刚开始在 Arch 上使用 VSCode，建议按这个顺序搭建：

1. 安装 code 或 visual-studio-code-bin；
2. 安装 Git、字体、语言运行时和常用开发工具；
3. 配置终端、字体、自动保存和格式化；
4. 按项目安装扩展；
5. 根据 Wayland、输入法、扩展市场等问题逐步微调。

最终目标不是把 VSCode 配成最复杂，而是配成最适合自己长期使用的开发环境。