前置依赖一览
本教程共 48 篇 · 第 5 篇 · 更新于 2026-08-09 · 约 8 分钟阅读
本节目标：在开始写第一行 Tauri 代码之前，先搞清楚电脑上必须装哪些东西，以及为什么它们一个都不能少。
Tauri 2.x 把”做桌面应用”拆成了三块拼图：用 Rust 写后端逻辑，用 Web 前端技术（HTML/CSS/JS）写界面，再用操作系统自带的 WebView 把界面渲染出来。要把这三块拼起来，你的电脑上得提前备好对应的工具。本章不深挖某个系统的安装步骤——那是后面三章的活儿——我们先把”要装什么、为什么装”在脑子里理清楚。
为什么不能跳过依赖直接写代码
你可能用过纯前端的脚手架，克隆下来 npm install 就能跑。Tauri 不一样：它最终产出的不是网页，而是一个能独立打开的桌面窗口程序。这个程序里既有需要编译的 Rust 代码，又有需要打包的前端资源，还得调用系统底层的图形与浏览器接口。
打个比方：Rust 工具链是发动机，Node.js 是装配流水线的扳手，WebView 是车灯背后的那块玻璃——三者到位，车才跑得起来。漏掉任何一个，编译阶段就会报错，而且报错信息往往不直接说”你没装 XX”，而是甩给你一长串看不懂的链接错误。所以咱们先把清单列全。
Note本教程以 Tauri 2.11.5 为基线版本。后面所有命令和配置都按 2.x 讲法，不涉及 1.x 的兼容写法。
Rust 工具链：后端的发动机
Tauri 的核心运行时用 Rust 编写，你的业务逻辑（命令、系统调用、插件）也要写 Rust。因此需要一套 Rust 工具链，它由三个部件组成：
- rustup：版本管理器，负责安装和切换 Rust 工具链（类似 Node 的 nvm）。
- rustc：Rust 编译器，把
.rs源码编译成机器码。 - cargo：包管理器与构建工具，负责拉取依赖、编译、运行、打包。
在 Windows 上有一个容易踩的点：Rust 默认提供两套工具链，一套叫 MSVC（适配 Visual Studio 的 C 运行时），一套叫 GNU（适配 MinGW）。Tauri 在 Windows 上必须用 MSVC 工具链，否则链接阶段会失败。安装时要确认默认目标三元组是 x86_64-pc-windows-msvc（或你机器对应的架构）。
装好后用两条命令验证：
rustc --version
cargo --version能看到版本号就说明发动机就位了。
Node.js 与前端工具链
如果你打算用 Vue、React、Svelte 这类前端框架写界面，那 Node.js 是绕不开的。它负责跑前端构建工具（比如 Vite），把你的源码打包成 Tauri 能加载的静态文件。
Tip只装 LTS（长期支持）版本 即可，不用追最新版。推荐用
nvm（Node Version Manager）管理版本，切换起来不折腾系统环境。
装完同样验证一下：
node -v
npm -v注意，Node.js 只在”用 JS 前端框架”时才必需。如果你用纯 Rust 前端（比如 Leptos、通过 trunk 打包），可以跳过它。但零基础教程里绝大多数读者会走 JS 框架路线，所以请装上。
包管理器三选一：npm / pnpm / yarn
Node.js 自带 npm，它是默认包管理器。但社区里还有 pnpm（快、省磁盘）和 yarn（老牌稳定）两个常见选择。三者功能等价，选哪个看个人习惯，Tauri 都支持。
想启用 pnpm 或 yarn，官方推荐用 Node.js 内置的 corepack（一个包管理器调度器）：
corepack enable这一步是可选的。不敲它，你就用默认的 npm，完全没问题。但在 npm create tauri-app 向导里选择包管理器时，如果你选了 pnpm/yarn，就得先确保 corepack enable 已执行，否则会报”找不到命令”。
WebView 是什么：Tauri 的”浏览器内核”
这是 Tauri 和 Electron 最大的区别，也是新手最容易糊涂的地方。
Electron 的做法是：把一个完整的 Chromium 浏览器打包进你的应用，所以安装包动辄一两百兆。Tauri 的做法更轻：它不打包浏览器，而是直接调用操作系统已经装好的 WebView 来渲染界面。WebView 就是系统级的”网页显示组件”，你的 HTML/CSS/JS 最终由它画到窗口上。
NoteWebView 不是你手动下载的某个 App，而是操作系统或系统库提供的一套渲染接口。Tauri 在编译和运行时通过系统 API 调用它。理解这一点，你就明白为什么不同平台要装不同的”系统依赖”了——因为每家的 WebView 来源不一样。
正因为依赖系统 WebView，Tauri 应用体积小、启动快。代价是：开发机必须先有这套 WebView，否则窗口打不开。
各平台的 WebView 来源
三大家族的 WebView 来自不同地方，记住这张对照表，后面三章你就知道在装什么了：
| 平台 | WebView 组件 | 技术内核 | 是否通常预装 |
|---|---|---|---|
| Windows | WebView2 | 基于 Microsoft Edge（Chromium） | Windows 10(1803+) / 11 一般已带 |
| macOS | WKWebView | 基于 WebKit（Safari 内核） | 随系统自带，无需单独装 |
| Linux | WebKitGTK（webkit2gtk-4.1） | 基于 WebKit | 多数发行版未预装，需手动装 |
- Windows 的 WebView2：微软把 Edge 的渲染能力开放成了系统组件。旧版 Windows 10 可能没装，需要去微软官网下”常青版引导程序”。
- macOS 的 WKWebView：苹果从 macOS 10.10 起就内置了，随系统更新。你不用单独装它，但要装好 Xcode Command Line Tools（它提供编译所需的 C 工具链，不是 WebView 本身）。
- Linux 的 WebKitGTK：这是一套开发库，发行版仓库里叫
webkit2gtk-4.1。因为 Linux 发行版太分散，几乎没有”预装”的保证，所以必须显式安装，并且还要带上编译用的开发包。
一张总清单
把上面三块拼起来，各平台最终要装的东西一目了然：
- Rust 工具链（全平台必装）：rustup + rustc + cargo，Windows 用 MSVC 版。
- Node.js + 包管理器（用 JS 前端时必装）：Node.js LTS，npm 默认，可选 pnpm/yarn。
- 系统 WebView 相关依赖（按平台）：
- Windows → WebView2 + Microsoft C++ 生成工具
- macOS → Xcode Command Line Tools（含 WKWebView 的系统库）
- Linux →
webkit2gtk-4.1及开发包 + 构建工具链
Warning新手最常犯的错误是”只装了 Rust 和 Node，以为大功告成”，结果
tauri dev一跑就报错。请记住：WebView 系的依赖是按平台分开的，后面三章会逐平台手把手带你装到位，别跳读。
小结
本章梳理了 Tauri 2 开发所需的三类前置依赖：Rust 工具链（rustup / rustc / cargo）、Node.js 与包管理器（npm / pnpm / yarn），以及各平台不同的 WebView 渲染组件——Windows 用 WebView2、macOS 用 WKWebView、Linux 用 WebKitGTK，三者缺一不可。理清了”要装什么”，下一章我们就从 Windows 起步，把每一步命令敲实。