背景
Windows 开发环境当前存在两类启动提示:
- 文档和交接说明要求执行
cargo tauri dev,但系统未安装 cargo-tauri 子命令,命令直接失败;
- 项目内 Tauri CLI 实际可通过
web/node_modules/@tauri-apps/cli 使用,但没有统一、明确的 Windows 启动入口;
- 当前 Node.js
20.17.0 可以完成构建,但 Vite 8.1.3 明确要求 Node 20.19+ 或 22.12+,启动时持续输出版本警告。
影响
- 新贡献者按文档无法直接启动桌面应用;
- Windows 环境容易误判为 Rust/Tauri 源码故障;
- 不同 Node 版本可能造成前端构建或原生依赖安装差异。
建议
- 在项目文档中统一 Windows/macOS/Linux 的 Tauri 启动命令;
- 优先使用项目锁定的 Tauri CLI,避免要求全局安装
cargo-tauri;
- 在
web/package.json 或项目文档中明确 Node 最低版本;
- 对不满足版本的环境尽早给出清晰、可操作的提示。
当前验证
以下命令可以启动项目:
cd src-tauri
node ..\\web\\node_modules\\@tauri-apps\\cli\\tauri.js dev
前端 pnpm build 和 pnpm test 均已通过。
背景
Windows 开发环境当前存在两类启动提示:
cargo tauri dev,但系统未安装cargo-tauri子命令,命令直接失败;web/node_modules/@tauri-apps/cli使用,但没有统一、明确的 Windows 启动入口;20.17.0可以完成构建,但 Vite8.1.3明确要求 Node20.19+或22.12+,启动时持续输出版本警告。影响
建议
cargo-tauri;web/package.json或项目文档中明确 Node 最低版本;当前验证
以下命令可以启动项目:
前端
pnpm build和pnpm test均已通过。