feat: 优化开发与生产模式端口管理及启动逻辑

- 更新开发模式说明,明确开发时需手动启动前端服务器并支持热重载,生产模式自动启动侧车二进制,优化端口管理策略并完善最佳实践文档。
- 根据开发模式自动切换端口检测逻辑,开发模式下直接连接本地3000端口并等待服务器就绪,生产模式下正常启动sidecar并扫描可用端口,提升开发体验和启动可靠性。
- 移除开发环境URL配置,使用默认的开发服务器地址
This commit is contained in:
2026-01-18 15:31:42 +08:00
parent c77eb6b2bd
commit a30d7c32fd
3 changed files with 141 additions and 63 deletions

View File

@@ -8,6 +8,8 @@
- **后端**: Rust (Edition 2021)
- **架构**: Sidecar 模式 - Sidecar Server 承载主要业务逻辑
- **设计理念**: Tauri 仅提供原生桌面能力文件对话框、系统通知等Web 逻辑全部由 Sidecar Server 处理
- **开发模式**: 使用 localhost:3000需手动启动开发服务器
- **生产模式**: 自动启动 Sidecar 二进制
- **异步运行时**: Tokio
- **Rust 版本**: 1.92.0+
- **工具管理**: 使用 mise 管理 Rust 和 Tauri CLI 版本(见 `mise.toml`
@@ -16,13 +18,22 @@
### 开发运行
```bash
# 开发模式运行 (带 hot-reload)
# 开发模式运行 (需要先启动开发服务器)
# 终端 1: 启动前端开发服务器
bun run dev
# 终端 2: 启动 Tauri 应用
tauri dev
# 仅运行 Rust 二进制 (不推荐,需要手动启动 Sidecar Server)
cargo run
# 或者使用单命令并行启动(需要配置 package.json
bun run dev:tauri
```
**开发模式说明**
- 开发模式下Tauri 直接连接到 `localhost:3000`(不启动 sidecar 二进制)
- 需要手动运行 `bun run dev` 来启动开发服务器
- 支持热重载HMR无需重启 Tauri 应用
### 构建
```bash
# 开发构建 (debug mode)
@@ -323,12 +334,17 @@ tokio = { version = "1", features = ["net"] }
## 最佳实践
1. **进程生命周期**: 始终在应用退出时清理子进程和资源
2. **端口管理**: 使用端口扫描避免硬编码端口冲突
3. **超时处理**: 异步操作设置合理的超时时间 (如 5 秒)
4. **日志**: 使用表情符号 (✓/✗) 和中文消息提供清晰的状态反馈
5. **错误退出**: 关键错误时调用 `std::process::exit(1)`
6. **窗口配置**: 使用 `WebviewWindowBuilder` 动态创建窗口
1. **开发环境配置**:
- 开发模式下需先启动前端开发服务器(`bun run dev`),再启动 Tauri`tauri dev`
- 生产构建自动打包 sidecar 二进制,无需额外配置
2. **进程生命周期**: 始终在应用退出时清理子进程和资源
3. **端口管理**:
- 开发模式固定使用 3000 端口(与开发服务器匹配)
- 生产模式使用端口扫描避免硬编码端口冲突
4. **超时处理**: 异步操作设置合理的超时时间 (如 5 秒)
5. **日志**: 使用表情符号 (✓/✗/🔧/🚀) 和中文消息提供清晰的状态反馈
6. **错误退出**: 关键错误时调用 `std::process::exit(1)`
7. **窗口配置**: 使用 `WebviewWindowBuilder` 动态创建窗口
## 提交代码前检查清单