在 macOS 上开发 Tauri 应用,环境配置的核心就两步:安装 Xcode Command Line Tools 和 安装 Rust 工具链。这两个是构建和运行 Tauri 项目的前提,缺一不可。
1. Xcode Command Line Tools
macOS 的 WebView(WKWebView)及其相关的系统框架、编译工具(如 clang、make)都包含在 Xcode Command Line Tools 中。Tauri 的 Rust 部分在编译时会链接这些系统库,所以必须先安装它们。
- 如何安装
打开终端,执行以下命令:
xcode-select --install
系统会弹出一个安装对话框,按照提示完成即可。整个过程大概需要几分钟。
- 验证安装
输入 xcode-select -p,如果返回 /Library/Developer/CommandLineTools 之类的路径,说明安装成功。你也可以用 cc --version 检查 C 编译器是否可用。
- 为什么不是完整 Xcode?
对于绝大多数 Tauri 开发场景,只需要 Command Line Tools,不需要安装庞大的 Xcode(体积约 10 GB+)。只有当你需要 iOS 模拟器或者要用 xcodebuild 打包 App Store 版本时,才需要完整 Xcode。
实用提示:macOS 系统更新后,有时需要重新执行 xcode-select --install 来更新工具链,否则 Rust 编译可能会报错找不到系统头文件。
2. Rust 环境
Tauri 的后端完全由 Rust 编写,因此必须安装 Rust 工具链,包括编译器 rustc、包管理器 cargo 和工具链管理器 rustup。
- 安装方法(推荐使用 rustup)
在终端运行官方安装脚本:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
按照提示选择默认安装即可。安装完成后,重启终端或者执行 source "$HOME/.cargo/env" 使环境变量生效。
- 验证安装
输入 rustc --version 和 cargo --version,看到版本号则表示安装成功。
- Tauri 对 Rust 的要求
Tauri v2 要求 Rust 版本至少为 1.77.2(具体以官方文档为准)。你可以用 rustup update 保持最新稳定版。
实用提示:在 macOS 上首次编译 Tauri 项目时,cargo 会下载和编译很多 Rust 依赖(crate),速度可能较慢。建议设置国内镜像源(例如字节跳动的 rsproxy.cn),在 ~/.cargo/config.toml 中添加:
[source.crates-io]
replace-with = 'rsproxy'
[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"
这样能显著提升依赖下载速度。
3. 二者如何协作?
Xcode Command Line Tools 提供了 macOS 平台底层的编译与链接能力,Rust 负责后端逻辑和安全控制,两者共同支撑 Tauri 应用在 macOS 上从编译到运行的完整过程。安装好这两个环境,你就可以在 macOS 上执行 cargo install tauri-cli,然后运行 tauri dev 或 tauri build 来开发和打包应用了。