在 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.0或webkit2gtk4.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-dev或pkg-config,补装即可。 - 运行报“找不到 WebKitWebContext”:通常是运行时未安装
webkit2gtk包,确保安装了开发包对应的运行时(一般已涵盖)。
一句话:装好 webkit2gtk4.1-devel + 基础编译工具,Tauri 在 Linux 上就能跑起来。