如何在 Ubuntu 26.04 LTS (Resolute Raccoon) 上安装 Visual Studio Code
你刚刚安装了 Ubuntu 26.04 LTS。桌面很干净，GNOME 50 看起来美极了。但还少一样东西——你的代码编辑器。说实话，虽然 GNOME 文本编辑器（原名 gedit）可以用来记记笔记，但你真正需要的是具备真正的 IntelliSense、调试功能、Git 集成以及那个庞大的扩展市场的编辑器。
这就是 Visual Studio Code。
VS Code 在 Linux 上已经走了很长的路。2026 年，在 Ubuntu 26.04 仅支持 Wayland 的 GNOME 50 会话中，有一个关键的调整你需要做，才能获得清晰、流畅的体验。本指南涵盖安装、Wayland 修复以及你第一天就会真正需要的扩展。
选项一：Microsoft APT 仓库（推荐）
在 Ubuntu 上安装 VS Code 的正确方式是通过 Microsoft 的官方 APT 仓库。这样可以自动通过 apt upgrade 获取更新，并获得最稳定的软件包。
步骤 1：安装依赖
sudo apt update
sudo apt install -y wget gpg步骤 2：导入 Microsoft 的 GPG 密钥
sudo install -d -m 0755 /etc/apt/keyrings
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /etc/apt/keyrings/packages.microsoft.gpg
sudo chmod 644 /etc/apt/keyrings/packages.microsoft.gpg步骤 3：添加 VS Code 仓库
echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list步骤 4：安装
sudo apt update
sudo apt install -y code验证是否安装成功：
code --version预期输出：1.xx.x 后跟一个提交哈希值和架构信息。
选项二：Snap（一条命令）
如果你偏好容器化软件包，VS Code 也可以作为 Snap 安装。这是最快的安装方式：
sudo snap install --classic code--classic 标志是必需的，因为 VS Code 需要完整的系统权限来使用其终端和调试器。
缺点： Snap 更新是自动且不可避免的。如果你不喜欢 Snap 的更新模式，请使用上面的 APT 方法。
选项三：手动下载 .deb
对于一次性安装或离线环境，直接下载 .deb 包：
wget -O code-latest.deb "https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64"
sudo dpkg -i code-latest.deb
sudo apt install -f # 修复任何缺失的依赖关键：GNOME 50 的 Wayland 修复
这是几乎所有指南都会忽略的部分。
Ubuntu 26.04 的 GNOME 50 仅支持 Wayland。 Electron 应用（包括 VS Code）默认通过 XWayland 运行。在 4K 或 HiDPI 显示器上，这会导致文字模糊和窗口拖动略有卡顿。
解决方法是一个配置文件，告诉 VS Code 原生使用 Wayland：
mkdir -p ~/.config
cat > ~/.config/code-flags.conf <<'EOF'
--ozone-platform-hint=auto
--enable-features=UseOzonePlatform,WaylandWindowDecorations
EOF它的作用：
--ozone-platform-hint=auto让 Electron 检测并在可用时使用 WaylandWaylandWindowDecorations启用原生 GNOME 客户端侧装饰
重启 VS Code。打开 Ctrl+Shift+P → “Developer: Open Process Explorer”。主进程现在应该显示 --ozone-platform-hint=auto。文字清晰度的差异立即可见。
这个标志文件也适用于 VS Code Insiders（code-insiders-flags.conf）和 OSS 构建版本（code-oss）。
必装扩展
VS Code 开箱即用已很实用，但下面这三个扩展能把它变成真正的开发环境。从终端安装，以便在多台机器上统一配置：
code --install-extension ms-python.python
code --install-extension ms-vscode-remote.remote-ssh
code --install-extension eamodio.gitlens- Python — IntelliSense、代码检查、调试、Jupyter 支持
- Remote – SSH — 在不离开 VS Code 的情况下编辑远程服务器上的文件
- GitLens — 内联 Git 责备、历史浏览器、Code Lens
启动 VS Code
从终端启动：
code .这将在 VS Code 中打开当前目录。你也可以打开特定文件：
code ~/project/main.py或者从 GNOME Activities 概览中搜索 "Visual Studio Code" 以图形方式启动。
卸载
如果通过 APT 安装：
sudo apt purge --autoremove -y code
sudo rm /etc/apt/sources.list.d/vscode.list
sudo rm /etc/apt/keyrings/packages.microsoft.gpg如果通过 Snap 安装：
sudo snap remove code总结
VS Code 在 Ubuntu 26.04 LTS 上运行得很好——只要你应用了那个 Wayland 标志。没有它，体验只能说一般。有了它，编辑器感觉原生且响应迅速，在任何缩放级别下文字都清晰锐利。
APT 方法是我推荐的方式：它让 VS Code 与系统更新同步，让你可以控制何时升级，并且在 amd64 和 arm64 机器上表现一致。安装扩展，应用 Wayland 修复，你就拥有了一个堪比 macOS 或 Windows 上的开发环境。
现在去构建点什么吧。
评论