1. 三条 Checklist：每一条都对应一个真实的坑
1.1 用 SSG（别走 SSR）
Tauri 的工作方式更像“静态站点宿主”：你给它一份静态资源目录（HTML/CSS/JS/WASM），它在 WebView 里加载并运行。官方明确：Tauri 不官方支持基于服务器的方案（SSR），因此要用 SSG/SPA/MPA 这类静态路线。 (Tauri)
这对 Leptos 意味着：在 Tauri 里通常跑的是 WASM 前端（客户端渲染），而不是把 Leptos 的服务端渲染端也一起塞进去。
1.2 serve.ws_protocol = "ws"：移动端热重载的关键开关
在移动端开发时（Android/iOS 真机或模拟器），热重载 websocket 更容易因为协议/网络环境出现连接问题。官方建议在 Trunk 里显式设置：
- ws_protocol = "ws"
确保热重载 websocket 能正常连上。 (Tauri)
1.3 开启 withGlobalTauri：让 window.__TAURI__ 可用，WASM 才好“抓”到 Tauri API
Leptos（WASM）要调用 Tauri API，最常见的桥接方式之一就是通过浏览器全局对象拿到 window.__TAURI__，再用 wasm-bindgen 或 JS interop 访问。官方要求在 Tauri 配置里打开：
- app.withGlobalTauri = true
这样 window.__TAURI__ 才会被注入。 (Tauri)
2. 示例配置 1：src-tauri/tauri.conf.json（告诉 Tauri：怎么跑 Trunk、资源在哪）
把下面这段放到 src-tauri/tauri.conf.json（或合并进你的配置）：
{
"build": {
"beforeDevCommand": "trunk serve",
"devUrl": "http://localhost:1420",
"beforeBuildCommand": "trunk build",
"frontendDist": "../dist"
},
"app": {
"withGlobalTauri": true
}
}
这段配置分别解决什么：
- beforeDevCommand: trunk serve 你执行 cargo tauri dev 时，Tauri 会先帮你启动 Trunk 的开发服务器。
- devUrl: http://localhost:1420 Tauri 开发模式加载的页面地址就是这个（Trunk 默认端口常用 1420）。
- beforeBuildCommand: trunk build 你执行 cargo tauri build 时，先把 Leptos 编译成静态资源。
- frontendDist: ../dist Trunk build 的输出目录（注意这是相对 src-tauri/ 的路径，所以通常是 ../dist）。
- withGlobalTauri: true 注入 window.__TAURI__，方便 WASM/vanilla JS 访问。 (Tauri)
3. 示例配置 2：Trunk.toml（Trunk 怎么 build、怎么 serve、怎么热重载）
在项目根目录创建/修改 Trunk.toml：
[build]
target = "./index.html"
[watch]
ignore = ["./src-tauri"]
[serve]
port = 1420
open = false
ws_protocol = "ws"
这里的重点：
- [build].target = "./index.html" 指定构建入口页面（Trunk 以它为入口组织资源与 wasm 输出）。
- [watch].ignore = ["./src-tauri"] 避免 Trunk 监听 Rust/Tauri 工程目录导致无意义的重编译或文件句柄压力（特别是 Windows/大型工程时会明显）。
- [serve].ws_protocol = "ws" 移动端热重载稳定性的关键项。 (Tauri)
4. 开发与构建：你实际只需要记住两条命令
开发（桌面）：
cargo tauri dev
发布构建：
cargo tauri build
因为你已经在 tauri.conf.json 里配置了 beforeDevCommand/beforeBuildCommand，所以通常不需要你手动先跑 trunk serve/build。
5. WASM 侧怎么用 Tauri API（思路）
开启 withGlobalTauri 后，window.__TAURI__ 会存在。官方 JS API 文档也明确：使用全局对象需要这个开关。 (Tauri)
在 Leptos/WASM 里常见做法是：
- 用 wasm-bindgen / web-sys 从 window 上取 __TAURI__
- 再调用你需要的模块（例如 event、window、path、plugin 等）
如果你更偏工程化，也可以在前端用一层 thin wrapper：把需要的 Tauri 能力封装成少量 JS 函数，再让 WASM 调这些函数，边界更清晰、类型更可控。
6. 常见问题速查
- 启动后白屏，但浏览器访问 http://localhost:1420 正常 优先检查 tauri.conf.json 里的 devUrl 端口是否与 Trunk 一致，以及是否启动了 trunk serve（看终端输出）。
- 热重载在移动端不工作 先确认 Trunk.toml 里 ws_protocol = "ws" 已设置。 (Tauri)
- WASM 里拿不到 window.__TAURI__ 检查 app.withGlobalTauri 是否为 true，并确认你是在 Tauri 窗口里运行（不是纯浏览器环境）。 (Tauri)
