# vxe-admin-template

**Repository Path**: x-extends/vxe-admin-template

## Basic Information

- **Project Name**: vxe-admin-template
- **Description**: Vxe 后台管理系统模板
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://vxeui.com/admin-template/
- **GVP Project**: No

## Statistics

- **Stars**: 50
- **Forks**: 18
- **Created**: 2024-09-23
- **Last Updated**: 2025-09-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: admin, 管理系统模板

## README

# Vxe 后台管理系统模板

一个基于 [Vxe UI](https://vxeui.com) 轻量级、极致流畅的系统模板

## 版本

基于 Vxe v4.x 对应 vue3.x 版本

## 浏览器支持

![Edge](https://raw.github.com/alrra/browser-logos/master/src/edge/edge_48x48.png) | ![Chrome](https://raw.github.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png) | ![Firefox](https://raw.github.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png) | ![Opera](https://raw.github.com/alrra/browser-logos/master/src/opera/opera_48x48.png) | ![Safari](https://raw.github.com/alrra/browser-logos/master/src/safari/safari_48x48.png)
--- | --- | --- | --- | --- |
80+ ✔ | 80+ ✔ | 90+ ✔ | 75+ ✔ | 10+ ✔ |

## 在线预览

👉 [点击查看 v4.x](https://vxeui.com/admin-template/)  
👉 [点击查看 v3.x](https://vxeui.com/admin-template-v3/)  

## 目录说明

* api 后台接口
* assets 静态资源（图片、视频等）
* components 全局组件
* i18n 国际化语言
* router 路由目录
  * config 路由配置文件（可按照业务进行模块拆分）
  * index 路由及权限控制
* store 全局数据仓库
  * app 应用通用数据
  * user 用户相关数据
* plugins 插件目录
  * vxe 组件库插件
    * form 表单渲染器
    * table 表格渲染器
    * config 全局默认参数
    * format 全局格式化
  * ...其他插件
* style 样式目录
  * theme 主题文件
* util 通用函数
* views
  * layout 页面布局
  * error 错误相关页面
  * login 登录注册
  * home 首页
  * systemManage 系统管理
  * ...业务模块

## 克隆代码
```
git clone https://gitee.com/x-extends/vxe-admin-template.git
```
或
```
git clone https://github.com/x-extends/vxe-admin-template.git
```

### 切换目录
```
cd vxe-admin-template192.168.0.5
```

### 设置镜像源(可忽略)
```
npm config set registry https://registry.npmmirror.com
```

### 更新依赖
```
npm run update
```

### 运行项目
```
npm run serve
```

### 打包zip
```
npm run build:zip
```

## index.html

首页 html 里面包含百度统计的脚本链接，记得正式使用时要移除掉。

## 修改 Logo 图片

* public/favicon.ico
* src/assets/logo.png

## 修改项目路径

vite.config.ts 修改为

```javascript
// ...
base: '/',
// ...
```

## 环境变量

.env 通用环境变量配置文件  
.env.production 正式环境变量配置文件

## 打包正式环境生成 dist 目录
```
npm run build
```

## 打包正式环境生成 zip 文件
```
npm run build:zip
```

## Contributors

Thank you to everyone who contributed to this project.

[![vxe-admin-template](https://contrib.rocks/image?repo=x-extends/vxe-admin-template)](https://github.com/x-extends/vxe-admin-template/graphs/contributors)

## License

[MIT](LICENSE) © 2019-present, Xu Liangzhan