人人都会AI编程

Linux:webkit2gtk、系统依赖库安装

更新时间:2026-07-11

在 Linux 上开发 Tauri,最大的障碍往往不是代码本身,而是系统依赖库的准备。因为 Tauri 使用 WebKitGTK 作为 WebView,而 Rust 编译也需要一些基础工具。以下是各发行版的安装方法,尽量用最新、最简洁的命令。


Ubuntu / Debian

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev \
  build-essential \
  curl \
  wget \
  file \
  libxdo-dev \
  libssl-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev

说明:libwebkit2gtk-4.1-dev 是核心,其余是窗口交互、系统托盘、TLS 等依赖。

Fedora / RHEL

sudo dnf check-update
sudo dnf install webkit2gtk4.1-devel \
  openssl-devel \
  curl \
  wget \
  file \
  libappindicator-gtk3-devel \
  librsvg2-devel
sudo dnf group install "C Development Tools and Libraries"

Arch Linux / Manjaro

sudo pacman -Syu
sudo pacman -S webkit2gtk-4.1 \
  base-devel \
  curl \
  wget \
  file \
  openssl \
  appmenu-gtk-module \
  libappindicator-gtk3 \
  librsvg

openSUSE

sudo zypper install webkit2gtk4.1-devel \
  gcc \
  curl \
  wget \
  file \
  libopenssl-devel \
  libappindicator3-1 \
  librsvg-devel
sudo zypper install -t pattern devel_basis

注意:不同发行版打包的 WebKit 版本号可能不同,如 webkit2gtk-4.0webkit2gtk4.1。Tauri 2.x 要求 4.1 及以上。如果安装后仍报找不到 webkit2gtk-4.1,可能需要添加特定 PPA(Ubuntu 20.04 需添加 deb http://cz.archive.ubuntu.com/ubuntu focal-updates main)或升级系统。


验证安装

运行以下命令检查 WebKit 版本:

pkg-config --modversion webkit2gtk-4.1

如果显示 2.44.x 之类,则安装成功。此外,确保 Rust 工具链已装好(rustc --version),Tauri CLI 也通过 cargo install tauri-cli --version "^2.0" 安装。


常见问题

  • “找不到 libwebkit2gtk-4.1:检查系统是否过旧(如 Ubuntu 18.04 不直接支持),可换用 Tauri 1.x 或升级系统。
  • 构建时链接错误:多数是缺少 libssl-devpkg-config,补装即可。
  • 运行报“找不到 WebKitWebContext”:通常是运行时未安装 webkit2gtk 包,确保安装了开发包对应的运行时(一般已涵盖)。

一句话:装好 webkit2gtk4.1-devel + 基础编译工具,Tauri 在 Linux 上就能跑起来。