使用 Tauri 开发跨平台桌面应用时，如何组织…

适用于使用 Tauri 构建跨平台桌面应用，并采用 TypeScript/React 前端与 Rust 后端的开发场景。

适用场景

解决思路

1. 编写干净、可维护的 TypeScript 和 Rust 代码。
2. 使用 TailwindCSS 和 ShadCN-UI 进行样式设计。
3. 对复杂功能遵循逐步规划。
4. 优先考虑代码质量、安全性和性能。
5. 前端使用 TypeScript、React/Next.js、TailwindCSS、ShadCN-UI。
6. 后端使用 Rust、Tauri APIs。
7. 使用 Tauri CLI、Vite/Webpack 构建。
8. 按以下结构组织项目：src/app/ 用于 Next.js app 目录；src/components/ui/ 用于 ShadCN-UI 组件；src/components/features/ 用于功能组件；src/hooks/ 用于自定义 React hooks；src/lib/ 用于工具函数；src/styles/ 用于全局样式；src-tauri/src/main.rs 为 Rust 入口；src-tauri/src/commands/ 用于 Tauri 命令；src-tauri/Cargo.toml 为 Rust 依赖；src-tauri/tauri.conf.json 为 Tauri 配置。
9. 使用函数组件和 TypeScript。
10. 为所有数据结构定义合适的接口。
11. 对异步操作使用 async/await。
12. 实现适当的错误处理。
13. 从 TypeScript 前端通过 import { invoke } from '@tauri-apps/api/tauri' 调用 Rust 命令，例如 const result = await invoke<string>('my_command', { arg: 'value' })。
14. 通过 import { listen } from '@tauri-apps/api/event' 监听 Rust 事件，例如 await listen('event-name', (event) => { console.log(event.payload) })。
15. 在 Rust 中用 #[tauri::command] 定义命令，例如 fn my_command(arg: String) -> Result<String, String>，并在 main 中通过 tauri::Builder::default().invoke_handler(tauri::generate_handler![my_command]).run(tauri::generate_context!()).expect(...) 注册。
16. 对可能失败的操作使用 Result 类型。
17. 在需要时定义自定义错误类型。
18. 适当地传播错误。
19. 记录错误以便调试。
20. 验证前端传入的所有输入。
21. 使用 Tauri 的安全功能（CSP、allowlist）。
22. 在 tauri.conf.json 中最小化权限。
23. 清理文件路径和用户输入。
24. 使用 utility-first 方法编写 TailwindCSS。
25. 实现响应式设计。
26. 支持深色模式。
27. 遵循一致的间距和尺寸。
28. 使用 ShadCN-UI 预构建的可访问组件。
29. 用 TailwindCSS 自定义 ShadCN-UI 组件。
30. 保持一致的 ShadCN-UI 主题。
31. 遵循可访问性最佳实践。
32. 使用 React Context 管理全局状态。
33. 对复杂状态考虑使用 Zustand。
34. 让状态靠近使用它的位置。
35. 实现与 Rust 的适当状态同步。
36. 在 Rust 中执行文件系统操作时，使用 std::fs 和 tauri::api::path::app_data_dir，定义 read_file(path: String) -> Result<String, String> 使用 fs::read_to_string(&path) 并通过 map_err(|e| e.to_string()) 转换错误，定义 write_file(path: String, content: String) -> Result<(), String> 使用 fs::write(&path, content) 并通过 map_err(|e| e.to_string()) 转换错误。
37. 配置正确的应用元数据。
38. 为分发设置代码签名。
39. 使用 Tauri 的 updater 实现自动更新。
40. 在所有目标平台上测试。
41. 最小化前端与 Rust 之间的 IPC 调用。
42. 尽可能使用批量操作。
43. 实现适当的缓存。
44. 分析并优化热点路径。
45. 为 Rust 命令编写单元测试。
46. 测试前端组件。
47. 实现集成测试。
48. 在所有目标平台上测试。

适用边界 · 注意事项

• 不适用于非 Tauri 项目，或不需要跨平台桌面应用（如纯 Web 应用、移动原生应用）的场景。
• 不适用于团队无法引入 Rust 工具链、Tauri CLI，或不想使用系统 WebView 的场景。
• 不适用于对包体积、内存占用或各平台 WebView 一致性有极端要求且未验证 Tauri 方案的情况。