在 Debian 12 上配置 Tauri 2 的开发环境

在 Debian 12 上配置 Tauri 2 的开发环境，你需要安装 Rust 工具链、系统依赖、Node.js 以及 Tauri CLI。虽然搜索结果中关于 Tauri 2 的专门信息较少，但核心的安装步骤与 Tauri 1 是相似的，以下是根据现有信息为你整理的完整配置指南。

🛠️ 安装系统基础依赖

首先，你需要安装 Tauri 所必需的系统基础依赖，这主要是 WebKitGTK 相关的库。

1. 打开终端，更新软件包列表并安装依赖：

   sudo apt update
   sudo apt install -y \
       libwebkit2gtk-4.0-dev \
       build-essential \
       curl \
       wget \
       file \
       libssl-dev \
       libgtk-3-dev \
       libappindicator3-dev \
       patchelf

   • libwebkit2gtk-4.0-dev 是 Tauri 在 Linux 上用于渲染界面的核心 Web 引擎 。
   • libgtk-3-dev 和 libappindicator3-1 是图形界面和系统托盘功能所需的 GTK 库 。

🔧 安装 Rust 工具链

Rust 是编译 Tauri 后端所必需的。建议通过 rustup 安装以获得最新的稳定版本。

1. 运行以下命令安装 rustup 和 Rust：

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

2. 安装完成后，按照提示将 Cargo（Rust 的包管理器）添加到当前用户的 PATH 环境变量中，或者重新启动终端。你也可以手动执行以下命令使其立即生效：

   source $HOME/.cargo/env

3. 验证安装是否成功：

   rustc --version
   cargo --version

   如果这两个命令都输出了版本号，说明 Rust 环境已配置成功 。

📦 安装 Node.js 与 npm

Tauri 项目通常使用 Node.js 来管理前端部分。建议安装 Node.js 的长期支持 (LTS) 版本 。

1. 你可以通过 Debian 官方源安装，但版本可能较旧。为了获取最新版本，建议使用 NodeSource 提供的最新 LTS 版本。例如：

   # 安装 curl 以确保能获取脚本 (上一步已安装，此步可省略)
   sudo apt install -y curl
   
   # 添加 NodeSource 仓库 (以 20.x LTS 为例，你可以在 NodeSource 官网查找最新版本)
   curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
   
   # 安装 Node.js 和 npm
   sudo apt install -y nodejs

2. 验证安装：

   node -v
   npm -v

⚡ 安装 Tauri CLI

现在，你可以安装 Tauri 的命令行接口 (CLI) 了，它将用于创建和管理 Tauri 项目。

使用 npm 全局安装 Tauri CLI：

sudo npm install -g @tauri-apps/cli

安装完成后，可以验证一下：

tauri --version

🚀 创建并运行你的第一个 Tauri 项目

环境配置完毕，现在可以创建一个新的 Tauri 项目并运行它了。

1. 使用 create-tauri-app 脚手架快速创建项目：

   npm create tauri-app@latest my-tauri-app

   执行命令后，脚手架会引导你完成项目配置，例如选择前端框架（Vanilla、Vue、React、Svelte等）和包管理器 。

2. 进入项目目录并启动开发服务器：

   cd my-tauri-app
   npm run tauri dev

   这个命令会开始编译 Rust 代码和前端资源，首次运行可能需要一些时间。完成后，应该会自动打开一个窗口，显示你的 Tauri 应用 。

💡 解决常见问题

• 加速 Rust 和 npm 下载：由于网络原因，你可能会遇到 Rust 的 crate 或 npm 包下载缓慢的问题。可以配置国内镜像源来显著提升下载速度。

  • 对于 Cargo (Rust)：在你的 $HOME/.cargo 目录下创建一个 config 文件，并添加如下内容 ：

    [source.crates-io]
    registry = "https://github.com/rust-lang/crates.io-index"
    replace-with = 'tuna'
    
    [source.tuna]
    registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
    
    [net]
    git-fetch-with-cli = true

  • 对于 npm：可以将注册表设置为国内镜像 ：

    npm config set registry https://registry.npmmirror.com/

• GLIBC 版本兼容性：如果你计划将应用分发到其他 Linux 发行版，需要注意 GLIBC 的兼容性问题。为了获得最好的兼容性，建议在较旧的 Linux 发行版（如 Ubuntu 18.04）上构建你的最终应用，或者使用 Docker 容器进行构建 。

• 使用 Docker 构建（可选）：为了确保一致的构建环境和跨平台兼容性，你可以考虑使用 Docker。社区提供了一些包含 Tauri 构建环境的镜像 。

  # 示例：使用 docker-compose 进行构建
  docker-compose -f docker-compose.yaml up

  你需要创建一个 docker-compose.yaml 文件来定义你的构建环境 。

希望这份指南能帮助你在 Debian 12 上顺利搭建 Tauri 2 的开发环境。如果在任何步骤遇到问题，可以仔细检查终端输出的错误信息，它们通常能提供解决问题的线索。祝你开发顺利！