Electron React Tpl

一个基于 Electron + Vite + React 的生产级桌面应用模板，内置窗口管理、自动更新、SQLite 数据库、国际化、暗色主题、单元测试等核心功能。

特性

• Electron 39 + Vite 7 + React 19 + TypeScript
• 多窗口管理：支持单例窗口、模态窗口、窗口状态持久化（位置/大小）
• 自动更新：基于 electron-updater，支持 macOS 和 Windows，用户可控下载和安装
• SQLite 数据库：使用 Node.js 内置 node:sqlite 模块，提供 SimpleSQLite 封装（仅主进程）
• 快捷键：全局快捷键与窗口内快捷键（Cmd/Ctrl + W/Q/R/M 等）
• 系统集成：托盘菜单、Dock 菜单（macOS）、自定义应用菜单
• 国际化：使用 react-i18next，支持中英文切换
• 暗色主题：基于 Ant Design 5.x + CSS 变量
• 单元测试：Vitest + React Testing Library，108+ 测试覆盖核心模块
• 日志：基于 electron-log，开发/生产环境自动切换目录

快速开始

环境要求

• Node.js 22.5+（建议使用 22.14.0 以上）
• pnpm 9+
• macOS（开发/打包），Windows/Linux 也支持

安装依赖

pnpm install