FlowPacs/yudao-ui-admin-vue3/README.md

125 lines
4.9 KiB
Markdown
Raw Normal View History

2022-12-20 16:36:54 +08:00
# 🌈 yudao-ui-admin-vue3 #
<p style="text-align: center">
<img src="https://img.shields.io/badge/-Vue3.2-34495e?logo=vue.j" alt="vue" />
<img src="https://img.shields.io/badge/-Vite4-646cff?logo=vite&logoColor=white" alt="vite" />
<img src="https://img.shields.io/badge/-TypeScript4.9-blue?logo=typescript&logoColor=white" alt="typescript" />
<img src="https://img.shields.io/badge/-Pinia2-yellow?logo=picpay&logoColor=white" alt="Pinia2" />
<img src="https://img.shields.io/badge/-ESLint-4b32c3?logo=eslint&logoColor=white" alt="eslint" />
<img src="https://img.shields.io/badge/-pnpm7-F69220?logo=pnpm&logoColor=white" alt="pnpm" />
<img src="https://img.shields.io/badge/-Prettier-ef9421?logo=Prettier&logoColor=white" alt="Prettier">
2022-11-23 15:18:59 +08:00
<img src="https://img.shields.io/badge/-Sass-1D365D?logo=Sass&logoColor=white" alt="Sass">
2022-12-20 16:36:54 +08:00
<img src="https://img.shields.io/badge/-Wind%20CSS-06B6D4?logo=Tailwind%20CSS&logoColor=white" alt="WindCSS">
</p>
2022-11-23 14:37:35 +08:00
2022-07-18 19:06:37 +08:00
## 介绍
2022-12-14 13:50:33 +08:00
- 基于 vue3.2+ TypeScript Element Plus 2.2.0+ Vite4 Pinia Vxe-table , Windicss 等开发的后台管理系统
2022-07-18 19:06:37 +08:00
## 注意事项
- 项目路径请不要使用中文命名!!!会造成解析乱码!!!请使用全英文路径!!!
2022-12-08 12:39:35 +08:00
- node >=16 ,pnpm >=7.1
2022-07-18 19:06:37 +08:00
- 开发建议使用 [谷歌浏览器-开发者版](https://www.google.cn/intl/zh-CN/chrome/dev/) 不支持 IE\QQ 等浏览器
2022-08-02 11:37:55 +08:00
### 点击查看[使用说明](./use.md)
2022-07-18 19:06:37 +08:00
### 前端依赖
2023-01-03 17:46:32 +08:00
| 框架 | 说明 | 版本 |
| --- | --- |--------|
2022-11-15 16:54:13 +08:00
| [Vue](https://staging-cn.vuejs.org/) | vue 框架 | 3.2.45 |
| [Vite](https://cn.vitejs.dev//) | 开发与构建工具 | 4.0.4 |
2023-01-03 17:46:32 +08:00
| [Element Plus](https://element-plus.org/zh-CN/) | Element Plus | 2.2.28 |
| [TypeScript](https://www.typescriptlang.org/docs/) | JavaScript 的超集 | 4.9.4 |
2022-12-14 13:50:33 +08:00
| [pinia](https://pinia.vuejs.org/) | Vue 存储库 替代 vuex5 | 2.0.28 |
| [vueuse](https://vueuse.org/) | 常用工具集 | 9.10.0 |
2023-01-12 13:55:32 +08:00
| [vxe-table](https://vxetable.cn/) | vue 最强表单 | 4.3.9 |
2023-01-03 17:46:32 +08:00
| [vue-i18n](https://kazupon.github.io/vue-i18n/zh/introduction.html/) | 国际化 | 9.2.2 |
| [vue-router](https://router.vuejs.org/) | vue 路由 | 4.1.6 |
| [windicss](https://cn.windicss.org/) | 下一代工具优先的 CSS 框架 | 3.5.6 |
2023-01-03 17:50:13 +08:00
| [iconify](https://icon-sets.iconify.design/) | 在线图标库 | 3.0.1 |
2022-11-15 16:54:13 +08:00
| [wangeditor](https://www.wangeditor.com/) | 富文本编辑器 | 5.1.23 |
2022-07-18 19:06:37 +08:00
### 推荐 VScode 开发,插件如下
- WindiCSS IntelliSense WindiCSS --- 自动完成、语法突出显示、代码折叠和构建等高级功能
- TypeScript Vue Plugin (Volar) --- 用于 TypeScript 的 Vue 插件
- Vue Language Features (Volar) --- Vue3.0 语法支持
- Iconify IntelliSense --- Iconify 预览和搜索
- i18n Ally --- 国际化智能提示
- Stylelint --- css 格式化
- DotENV --- .env 文件高亮
- Prettier --- 代码格式化
- ESLint --- 脚本代码检查
### 安装 pnpm 并启动项目
2022-07-20 15:26:53 +08:00
- 查看当前 npm 源
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
```bash
2022-07-18 19:06:37 +08:00
npm config ls
2022-07-20 15:26:53 +08:00
```
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
- 如果执行上面命令您并未看到 registry = "https://registry.npmjs.org/"说明使用的非npm官方源请执行下面命令
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
```bash
2022-07-18 19:06:37 +08:00
npm config set registry https://registry.npmjs.org
2022-07-20 15:26:53 +08:00
```
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
- 如果您还没安装 pnpm请执行下面命令
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
```bash
2022-07-18 19:06:37 +08:00
npm install -g pnpm
2022-07-20 15:26:53 +08:00
```
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
- mac 用户遇到安装报错请在命令前加上 sudo
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
- 安装依赖
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
```bash
2022-07-18 19:06:37 +08:00
pnpm install
2022-07-20 15:26:53 +08:00
```
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
- 运行项目
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
```bash
2022-11-18 09:20:11 +08:00
pnpm dev
2022-07-20 15:26:53 +08:00
```
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
- 打包
2022-07-19 18:23:13 +08:00
2022-07-20 15:26:53 +08:00
```bash
2022-07-19 18:23:13 +08:00
pnpm run build:pro
2022-07-20 15:26:53 +08:00
```
2022-07-19 18:23:13 +08:00
2022-07-20 15:26:53 +08:00
- 安装一个包
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
```bash
2022-07-18 19:06:37 +08:00
pnpm add 包名
2022-07-20 15:26:53 +08:00
```
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
- 卸载一个包
2022-07-18 19:06:37 +08:00
2022-07-20 15:26:53 +08:00
```bash
2022-07-18 19:06:37 +08:00
pnpm remove 包名
```
2022-11-18 09:20:11 +08:00
- 设置镜像源
```bash
pnpm config set registry https://registry.npm.taobao.org/
```
- 其他命令请看 package.json scripts
2022-07-20 15:26:53 +08:00
2022-07-18 19:06:37 +08:00
## 浏览器支持
本地开发推荐使用 `Chrome 80+` 浏览器
支持现代浏览器, 不支持 IE ,QQ 等
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/archive/internet-explorer_9-11/internet-explorer_9-11_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 |