# ruoyi-vue-vben5

**Repository Path**: laughingyou/ruoyi-vue-vben5

## Basic Information

- **Project Name**: ruoyi-vue-vben5
- **Description**: 基于vben5重写ruoyi-vue的前端项目
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 45
- **Forks**: 16
- **Created**: 2025-03-25
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![license](https://img.shields.io/github/license/anncwb/vue-vben-admin.svg)](LICENSE)

## 提示

该仓库使用vben最新版本v5对若依前端项目进行了全部重写

项目参考了[RuoYi-Vue-Plus](https://gitee.com/dapppp/ruoyi-plus-vben5)，需要多租户的可移步

v5版本采用分仓(包)目录结构, 具体开发路径为: `根目录/apps/web-ele`

## 简介

基于 [vben5 & element-plus](https://github.com/vbenjs/vue-vben-admin) 的 RuoYi-Vue 前端项目

| 组件/框架    | 版本   |
| :----------- | :----- |
| vben         | 5.5.3  |
| element-plus | 4.2.6  |
| vue          | 3.5.13 |

后端项目地址 [RuoYi-Vue](https://gitee.com/y_project/RuoYi-Vue)

## 文档

[Vben V5 文档地址](https://doc.vben.pro/)

## 预览图

![](scripts/preview/1.png)

![](scripts/preview/2.png)

![](scripts/preview/3.png)

![](scripts/preview/4.png)

![](scripts/preview/5.png)

## 安装使用

前置准备环境(只能用pnpm)

```json
"packageManager": "pnpm",
"engines": {
  "node": ">=20.15.0",
  "pnpm": "latest"
},
```

- 获取项目代码

```bash
git clone https://gitee.com/laughingyou/ruoyi-vue-vben5.git
```

- 安装依赖

```bash
cd ruoyi-vue-vben5

pnpm install
```

- 菜单图标替换

参考 [菜单图标替换](https://dapdap.top/guide/quick-start.html#%E8%8F%9C%E5%8D%95%E5%9B%BE%E6%A0%87%E5%AF%BC%E5%85%A5)

- 关于代码生成

V5版本代码生成模板

- 还是使用的若依老接口，所以生成的还是vue2版本的代码，需要的可以自行重写开发！！！

- 运行

```bash
pnpm dev:ele
```

- 打包

```bash
pnpm build:ele
```

## Git 贡献提交规范

- 参考 [vue](https://github.com/vuejs/vue/blob/dev/.github/COMMIT_CONVENTION.md) 规范 ([Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular))

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

## 浏览器支持

最低适配应该为`Chrome 88+`以上浏览器 详见 [css - where](https://developer.mozilla.org/en-US/docs/Web/CSS/:where#browser_compatibility)

本地开发推荐使用`Chrome` 最新版本浏览器

支持现代浏览器, 不支持 IE

| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari |
| :-: | :-: | :-: | :-: | :-: |
| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |