在 JetBrains IDE 中调试
在本指南中,我们将设置 JetBrains RustRover 以调试 Tauri 应用的核心进程。这也主要适用于 IntelliJ 和 CLion。
设置 Cargo 项目
根据项目中使用的前端堆栈,项目目录可能是也可能不是 Cargo 项目。默认情况下,Tauri 将 Rust 项目放置在名为 src-tauri
的子目录中。仅当 Rust 也用于前端开发时,它才会在根目录中创建 Cargo 项目。
如果在顶层没有 Cargo.toml
文件,则需要手动附加项目。打开 Cargo 工具窗口(在主菜单中,转到 视图 | 工具窗口 | Cargo),单击工具栏上的 + (附加 Cargo 项目),然后选择 src-tauri/Cargo.toml
文件。
或者,您可以通过将以下文件添加到项目的根目录来手动创建顶级 Cargo 工作区
[workspace]members = ["src-tauri"]
在继续之前,请确保您的项目已完全加载。如果 Cargo 工具窗口显示工作区的所有模块和目标,则表示一切就绪。
设置运行配置
您将需要设置两个单独的运行/调试配置
- 一个用于在调试模式下启动 Tauri 应用,
- 另一个用于运行您选择的前端开发服务器。
Tauri 应用
- 在主菜单中,转到 运行 | 编辑配置。
- 在 运行/调试配置 对话框中
- 要创建新配置,请单击工具栏上的 + 并选择 Cargo。
创建完成后,我们需要配置 RustRover,以便它指示 Cargo 构建我们的应用,而不使用任何默认功能。这将告诉 Tauri 使用您的开发服务器,而不是从磁盘读取资源。通常,此标志由 Tauri CLI 传递,但由于我们在此完全绕过了它,因此我们需要手动传递该标志。
现在我们可以选择性地将运行/调试配置重命名为更易于记忆的名称,在本例中,我们将其称为“Run Tauri App”,但您可以根据需要命名。
开发服务器
上述配置将直接使用 Cargo 构建 Rust 应用程序并将调试器附加到它。这意味着我们完全绕过了 Tauri CLI,因此像 beforeDevCommand
和 beforeBuildCommand
这样的功能将不会被执行。我们需要通过手动运行开发服务器来处理这个问题。
要创建相应的运行配置,您需要检查正在使用的实际开发服务器。查找 src-tauri/tauri.conf.json
文件并找到以下行
"beforeDevCommand": "pnpm dev"
对于 npm
、pnpm
或 yarn
,您可以使用 npm 运行配置,例如
确保您在 命令、脚本 和 包管理器 字段中具有正确的值。
如果您的开发服务器是用于基于 Rust 的 WebAssembly 前端框架的 trunk
,则可以使用通用的 Shell 脚本 运行配置
启动调试会话
要启动调试会话,您首先需要运行您的开发服务器,然后通过单击运行配置切换器旁边的 Debug 按钮来开始调试 Tauri 应用。RustRover 将自动识别放置在项目中的任何 Rust 文件中的断点,并在命中的第一个断点处停止。
从这一点开始,您可以探索变量的值,进一步步入代码,并详细检查运行时发生的情况。
© 2025 Tauri 贡献者。CC-BY / MIT