项目结构
Tauri 项目通常由两部分组成:一个 Rust 项目和一个 JavaScript 项目(可选)。典型的设置如下所示:
.├── package.json├── index.html├── src/│ ├── main.js├── src-tauri/│ ├── Cargo.toml│ ├── Cargo.lock│ ├── build.rs│ ├── tauri.conf.json│ ├── src/│ │ ├── main.rs│ │ └── lib.rs│ ├── icons/│ │ ├── icon.png│ │ ├── icon.icns│ │ └── icon.ico│ └── capabilities/│ └── default.json在此方案中,JavaScript 项目位于顶层,而 Rust 项目位于 src-tauri/ 文件夹内。这个 Rust 项目是一个标准的 Cargo 项目,但包含了一些额外的文件。
tauri.conf.json是 Tauri 的主要配置文件。它包含了从应用程序标识符到开发服务器 URL 等所有信息。此文件也是 Tauri CLI 用来定位 Rust 项目的标记。若要了解更多信息,请参阅 Tauri 配置。capabilities/目录是 Tauri 读取功能(Capability)文件的默认文件夹(简而言之,你需要在此处允许命令,以便在 JavaScript 代码中使用它们)。若要了解更多信息,请参阅安全性。icons/目录是tauri icon命令的默认输出目录。它通常在tauri.conf.json > bundle > icon中被引用,并用于应用的图标。build.rs包含了用于 Tauri 构建系统的tauri_build::build()调用。src/lib.rs包含了 Rust 代码和移动端入口点(标记为#[cfg_attr(mobile, tauri::mobile_entry_point)]的函数)。我们不在main.rs中直接编写代码,是因为在移动端构建时,我们将应用编译为库,并通过平台框架加载它。src/main.rs是桌面端的默认入口点。我们在main中运行app_lib::run()以复用与移动端相同的入口点。为了保持简单,请不要修改此文件,而是修改lib.rs。注意app_lib对应于Cargo.toml中的[lib.name]。
Tauri 的工作方式类似于静态 Web 主机。其构建过程是:首先将 JavaScript 项目编译为静态文件,然后编译 Rust 项目,并将这些静态文件打包进去。因此,JavaScript 项目的设置基本与构建静态网站相同。若要了解更多信息,请参阅 前端配置。
如果你只想使用 Rust 代码,只需移除其他所有内容,并将 src-tauri/ 文件夹作为你的顶层项目,或者作为 Rust 工作空间(Workspace)的一个成员即可。
© 2026 Tauri 贡献者。CC-BY / MIT