# Vue3 Admin Electron 脚手架

**Repository Path**: darkwinoom/vue3-admin-electron-scaffold

## Basic Information

- **Project Name**: Vue3 Admin Electron 脚手架
- **Description**: Vue3 Admin 前端脚手架的 Electron 版本
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 10
- **Forks**: 5
- **Created**: 2025-07-04
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Electron, TypeScript, vue3

## README

# Vue3 Admin Electron脚手架

在 [Vue3 Admin 前端脚手架](https://gitee.com/darkwinoom/vue3-admin-scaffold) 的基础上开发的 Electron 版本，完整保留原有功能，核心部分代码基本一致。

![登录界面](./docs/login.png)

![内部界面](./docs/inner.png)

## 依赖说明

基于 [electron-pure-admin](https://github.com/pure-admin/electron-pure-admin) 二次开发，目前已同步版本6.3.0。

完美复刻 WEB 版 [vue3-admin-scaffold](https://gitee.com/darkwinoom/vue3-admin-scaffold)，并针对桌面端进行了部分适配

## 安装使用

本项目使用 [pnpm](https://pnpm.io/) 进行包管理，推荐 Node.js 22 LTS

```sh
# 安装依赖
pnpm install

# 运行：桌面端 & 浏览器端
pnpm dev

# 运行：仅浏览器端
pnpm browser:dev

# 打包：桌面端
pnpm build

# 打包：浏览器端
pnpm browser:build

# 打包分析
pnpm report
```

### 安装问题

若无法正常完成安装，可尝试以下解决方案：

```sh
# 设置镜像源
pnpm config set registry https://registry.npmmirror.com/

# 解决 Electron 安装卡住问题
pnpm config set electron_mirror https://npmmirror.com/mirrors/electron/
```

## 开发方向

- [x] 实现项目 vue3-admin-scaffold 中全部功能，并持续同步更新
- [x] 适配多种分辨率（最底 1024 x 768）
- [x] 优化加载画面、异常处理与部分离线访问机制
- [x] 调整部分页面与功能，使其更适配桌面端操作习惯
- [ ] 支持应用内更新功能

待加入...

## Git 提交规范

| 类型       | 说明                           |
| ---------- | ------------------------------ |
| `feat`     | 增加新的业务功能               |
| `fix`      | 修复业务问题/BUG               |
| `perf`     | 优化性能                       |
| `style`    | 更改代码风格，不影响运行结果   |
| `refactor` | 重构代码                       |
| `revert`   | 撤销更改                       |
| `test`     | 测试相关，不涉及业务代码的更改 |
| `docs`     | 文档和注释相关                 |
| `chore`    | 更新依赖/修改脚手架配置等琐事  |
| `workflow` | 工作流改进                     |
| `ci`       | 持续集成相关                   |
| `types`    | 类型定义文件更改               |
| `wip`      | 开发中                         |

## 附：版本说明

本项目目前已更新为 `pnpm`，原 `yarn` 版本已停止更新，可通过访问标签 [1.0-yarn-version](https://gitee.com/darkwinoom/vue3-admin-electron-scaffold/tree/v1.0.yarn-version)查看。

## 附：参考文档

- [Vue3 Admin 前端脚手架](https://gitee.com/darkwinoom/vue3-admin-scaffold)
- [electron-pure-admin](https://github.com/pure-admin/electron-pure-admin)
- [Electron 官方文档](https://www.electronjs.org/zh/docs/latest/)