环境准备

在开始之前，请确保你的开发环境满足以下要求。

系统要求

操作系统	最低版本
Windows	10 (1803+)
macOS	10.15+
Linux	各主流发行版

必要工具

1. Rust 工具链

# 安装 Rust（官方推荐方式，使用 stable 工具链）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Windows 用户访问
# https://rustup.rs 下载安装器

# 验证安装
rustc --version
cargo --version

2. Node.js 环境

# 前端构建使用 Vite 7，要求 Node.js 20.19+ 或 22.12+
node --version   # >= 20.19.0
pnpm --version   # 项目使用 pnpm（>= 8），beforeDevCommand / beforeBuildCommand 都调用 pnpm

为什么必须是 pnpm

src-tauri/tauri.conf.json 的 build.beforeDevCommand 是 pnpm dev:clean、beforeBuildCommand 是 pnpm build，仓库里提交的锁文件也是 pnpm-lock.yaml。用 npm / yarn 启动会在执行这两条前置命令时失败。

3. 系统依赖

WindowsmacOSLinux (Ubuntu/Debian)

# 需要安装 Visual Studio Build Tools
# 包含 "C++ 桌面开发" 工作负载
# 以及 Windows 10/11 SDK
# 另需 WebView2 运行时（Windows 11 已预装；Windows 10 若缺失请从微软官网安装）

xcode-select --install

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

4. 推荐编辑器

VS Code + 以下扩展（前两项已写在仓库 .vscode/extensions.json 的推荐列表里，打开项目会自动提示安装）：
- rust-analyzer（Rust 语言支持）
- Tauri（Tauri 开发工具）
- ES7+ React/Redux/React-Native（React 片段）
- Tailwind CSS IntelliSense

验证环境

# 检查所有工具是否就绪
rustc --version && cargo --version && node --version && pnpm --version

一切就绪后，前往快速开始创建你的第一个项目。