162 lines
5.5 KiB
Markdown
162 lines
5.5 KiB
Markdown
# SnowAdmin
|
||
|
||
### 介绍 📖
|
||
|
||
SnowAdmin 一款基于 Vue3、TypeScript、Vite5、Pinia、Arco-Design 开源的后台管理框架，符合直觉的使用模式，使用目前最新技术栈开发。项目提供了一些常用组件，在一定程度上提高您的开发效率。另外本项目还封装了一些常用组件、Hooks、动态路由等功能。
|
||
|
||
### 在线预览 👀
|
||
|
||
- 链接：建设中
|
||
|
||
### 代码仓库 ⭐
|
||
|
||
- Gitee：https://gitee.com/wang_fan_w/SnowAdmin
|
||
|
||
### 项目文档 📚
|
||
|
||
- 项目更新日志：建设中
|
||
|
||
- 项目文档地址：建设中
|
||
|
||
### 项目功能 🔨
|
||
|
||
- 使用 Vue3 + TypeScript 开发，单文件组件**＜script setup＞**
|
||
- 采用 Vite5 作为项目开发
|
||
- 使用 Pinia 替代 Vuex，轻量、简单、易用，集成 Pinia 持久化插件
|
||
- 使用 TypeScript 对 Axios 整个二次封装（请求拦截、取消、常用请求封装…）
|
||
- 支持 Arco-Design 组件大小切换、多主题布局、暗黑模式、i18n 国际化
|
||
- 使用 VueRouter 配置动态路由权限拦截、路由懒加载，支持页面按钮权限控制
|
||
- 使用 KeepAlive 对页面进行缓存，支持多级嵌套路由缓存
|
||
- 使用 Prettier 统一格式化代码，集成 ESLint、Stylelint 代码校验规范
|
||
- 使用 husky、lint-staged、commitlint等插件，规范提交信息
|
||
|
||
### 预览
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
### 安装使用步骤 📔
|
||
|
||
- **Clone：**
|
||
|
||
```text
|
||
# Gitee
|
||
git clone https://gitee.com/wang_fan_w/SnowAdmin.git
|
||
```
|
||
|
||
- **Install：**
|
||
|
||
```text
|
||
pnpm install
|
||
```
|
||
|
||
- **Run：**
|
||
|
||
```text
|
||
pnpm dev
|
||
```
|
||
|
||
- **Build：**
|
||
|
||
```text
|
||
# 开发环境
|
||
pnpm run dev
|
||
|
||
# 测试环境
|
||
pnpm run preview
|
||
|
||
# 生产环境
|
||
pnpm run build
|
||
```
|
||
|
||
- **Lint：**
|
||
|
||
```text
|
||
# eslint 检测代码
|
||
pnpm lint:eslint
|
||
|
||
# prettier 格式化代码
|
||
pnpm lint:prettier
|
||
```
|
||
|
||
### 项目截图 📷
|
||
|
||
- 登录页：
|
||
|
||
- 首页：
|
||
|
||
- 表格页：
|
||
|
||
- 用户中心：
|
||
|
||
- 系统配置页：
|
||
|
||
### 文件资源目录 📚
|
||
|
||
```text
|
||
SnowAdmin
|
||
├─ .husky # husky 配置文件
|
||
├─ .vscode # VSCode 推荐配置
|
||
├─ public # 静态资源文件（该文件夹不会被打包）
|
||
├─ src
|
||
│ ├─ api # API 接口管理
|
||
│ ├─ assets # 静态资源文件
|
||
│ ├─ components # 全局组件
|
||
│ ├─ config # 全局配置项
|
||
│ ├─ directives # 全局指令文件
|
||
│ ├─ hooks # 常用 Hooks 封装
|
||
│ ├─ lang # 语言国际化 i18n
|
||
│ ├─ layout # 框架布局模块
|
||
│ ├─ router # 路由管理
|
||
│ ├─ store # pinia store
|
||
│ ├─ style # 全局样式文件
|
||
│ ├─ typings # 全局 ts 声明
|
||
│ ├─ utils # 常用工具库
|
||
│ ├─ views # 项目所有页面
|
||
│ ├─ App.vue # 项目主组件
|
||
│ ├─ main.ts # 项目入口文件
|
||
│ └─ vite-env.d.ts # 指定 ts 识别 vue
|
||
├─ .env # vite 常用配置
|
||
├─ .env.development # 开发环境配置
|
||
├─ .env.production # 生产环境配置
|
||
├─ .env.test # 测试环境配置
|
||
├─ .eslintignore # 忽略 Eslint 校验
|
||
├─ .eslintrc.cjs # Eslint 校验配置文件
|
||
├─ .gitignore # 忽略 git 提交
|
||
├─ .prettierignore # 忽略 Prettier 格式化
|
||
├─ .prettierrc.cjs # Prettier 格式化配置
|
||
├─ commitlint.config.cjs # git 提交规范配置
|
||
├─ index.html # 入口 html
|
||
├─ package-lock.json # 依赖包包版本锁
|
||
├─ package.json # 依赖包管理
|
||
├─ README.md # README 介绍
|
||
├─ tsconfig.json # typescript 全局配置
|
||
└─ vite.config.ts # vite 全局配置文件
|
||
```
|
||
|
||
### 浏览器支持 🌎
|
||
|
||
- 本地开发推荐使用 Chrome 最新版浏览器 [Download](https://www.google.com/intl/zh-CN/chrome/)。
|
||
- 生产环境支持现代浏览器，不再支持 IE 浏览器，更多浏览器可以查看 [Can I Use Es Module](https://caniuse.com/?search=ESModule)。
|
||
|
||
|  |  |  |  |  |
|
||
| :---------------------------------------------: | :-----------------------------------------------: | :--------------------------------------------------: | :-------------------------------------------------: | :-------------------------------------------------: |
|
||
| not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
|
||
|
||
### 项目后台接口 🧩
|
||
|
||
建设中
|