Leptos + Tauri 2 实战：Trunk 配置与移动端热重载指南

Trunk 构建配置

在项目根目录创建或修改 Trunk.toml：

[build]
target = "./index.html"

[watch]
ignore = ["./src-tauri"]

[serve]
port = 1420
open = false
ws_protocol = "ws"

重点说明：

• [build].target：指定入口页面，Trunk 以此组织资源和 WASM 输出。
• [watch].ignore：忽略 Rust/Tauri 工程目录，避免无意义的重编译或文件句柄压力。
• [serve].ws_protocol：移动端热重载稳定性的关键项。

开发与构建命令

配置好后，实际只需要记住两条命令：

开发（桌面）：

cargo tauri dev

发布构建：

cargo tauri build

因为已经在 tauri.conf.json 里配置了前置命令，通常不需要手动先跑 trunk serve/build。

WASM 调用 Tauri API

开启 withGlobalTauri 后，window.__TAURI__ 就会存在。在 Leptos/WASM 里常见做法是：

• 用 wasm-bindgen / web-sys 从 window 上取 __TAURI__
• 再调用需要的模块（如 event、window、path、plugin 等）

如果你更偏工程化，也可以在前端封装一层 thin wrapper，把 Tauri 能力包装成少量 JS 函数，让 WASM 去调，边界更清晰，类型也更可控。

常见问题排查

• 启动后白屏，但浏览器访问正常 优先检查 tauri.conf.json 里的 devUrl 端口是否与 Trunk 一致，以及是否成功启动了 trunk serve。

• 热重载在移动端不工作 先确认 Trunk.toml 里 ws_protocol = "ws" 已设置。

• WASM 里拿不到 window.__TAURI__ 检查 app.withGlobalTauri 是否为 true，并确认你是在 Tauri 窗口里运行，而非纯浏览器环境。