从零开始5 分钟内让你的本地开发者工具箱跑起来。本文覆盖环境准备、安装运行、打包发布全流程。什么是 WAToolsWATools 是一款基于Tauri 2 Vue 3的桌面开发者工具箱提供 JSON 格式化、JWT 解析、时间转换等常用工具所有数据处理均在本地完成安全放心。环境准备在开始之前确保你的电脑已安装以下工具工具最低版本下载地址Node.js 18nodejs.orgpnpm 8npm install -g pnpmRust 1.75rustup.rs验证环境打开终端依次检查node --version # 应输出 v18.x 或更高 pnpm --version # 应输出 8.x 或更高 rustc --version # 应输出 rustc 1.75.x 或更高Windows 用户提示安装 Rust 时需要 Visual Studio C Build ToolsRust 安装器会自动引导你安装。克隆项目git clone https://gitcode.com/white_chuan/WATools.git cd WATools安装依赖pnpm install这一步会安装前端依赖Vue 3、Pinia、Vue Router 等。Rust 依赖会在首次编译时自动下载。开发模式运行pnpm tauri dev首次运行会编译 Rust 后端需要等待 1~3 分钟后续增量编译很快。编译完成后会自动弹出应用窗口。开发模式特性热重载修改 Vue 前端代码后界面自动刷新DevTools按F12可打开浏览器开发者工具进行调试增量编译修改 Rust 代码后只需等待增量编译通常几秒界面概览应用启动后你会看到左侧侧边栏工具列表点击切换工具顶部导航应用标题和主题切换入口中间区域当前工具的操作界面构建安装包当你想生成可分发的安装包时pnpm tauri build构建产物位置src-tauri/target/release/ ├── bundle/ │ ├── msi/ # Windows MSI 安装包 │ └── nsis/ # Windows EXE 安装包 └── watools.exe # 可直接运行的可执行文件常见问题Q: 首次pnpm tauri dev编译失败确保已安装 Rust 工具链和 C Build ToolsWindows。尝试rustup update cargo install tauri-cli --version ^2Q: 应用启动后白屏检查终端是否有报错。常见原因是tauri.conf.json中的 SQL 插件preload配置格式不正确确保是字符串数组plugins: { sql: { preload: [sqlite:watools.db] } }Q: 如何更新到最新版本git pull origin main pnpm install pnpm tauri devQ: 进行pnpm tauri build失败编译最后会去github上拉取msi和nsis的包可能需要自己挂个梯子多试几次。下一步安装完成后你可以阅读以下使用指南深入了解每个工具JSON 格式化工具完全指南时间转换工具使用指南JWT 解析工具使用指南主题切换与个性化配置觉得 WATools 好用来 GitCode 点个 ⭐ Star支持开源
