Skip to content

docs(windows): document project-local Tauri CLI and supported Node version #225

Description

@jiahao07A

背景

Windows 开发环境当前存在两类启动提示:

  1. 文档和交接说明要求执行 cargo tauri dev,但系统未安装 cargo-tauri 子命令,命令直接失败;
  2. 项目内 Tauri CLI 实际可通过 web/node_modules/@tauri-apps/cli 使用,但没有统一、明确的 Windows 启动入口;
  3. 当前 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 buildpnpm test 均已通过。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions