refactor(framework): 更新注解和流操作以提高代码质量

This commit is contained in:
2026-02-27 16:08:41 +08:00
parent dc3fb8fdfc
commit 1b1bb10089
10 changed files with 124 additions and 126 deletions
+101 -101
View File
@@ -1,101 +1,101 @@
# cutejava-ui
## 前端模板
初始模板基于: [https://github.com/PanJiaChen/vue-element-admin](https://github.com/PanJiaChen/vue-element-admin)
模板文档: [https://panjiachen.github.io/vue-element-admin-site/zh/guide/](https://panjiachen.github.io/vue-element-admin-site/zh/guide/)
## 快速开始
#### 环境要求
**推荐 node 版本:16**
#### 安装依赖
``` bash
# 安装依赖(依赖python)
npm install --registry https://registry.npmmirror.com
```
#### 启动服务
```bash
# 启动服务 localhost:8013
npm run dev
# (或) 启动服务 localhost:8013
IDEA -> Current File -> Edit Configurations... -> Add New Configuration -> npm -> Script选dev -> Apply -> Ok
# 构建生产环境
npm run build:prod
# 本地预览生产环境
npm run preview
```
## 命令说明
#### 开发相关
```shell
# 启动本地开发服务器,默认端口 8013,支持热重载
npm run dev
# Windows 系统启动开发服务器,设置 OpenSSL 兼容性选项
npm run dev-win
# Linux 系统启动开发服务器,设置 OpenSSL 兼容性选项
npm run dev-linux
```
#### 构建相关
```shell
# 构建开发环境版本,输出到 dist 目录
npm run build:dev
# 构建预发布环境版本,输出到 dist 目录
npm run build:stage
# 构建生产环境版本,输出到 dist 目录
npm run build:prod
# 构建生产环境版本(无特定模式)
npm run build:production
```
#### 辅助命令
```shell
# 预览构建后的静态文件,启动本地服务器查看构建结果
npm run preview
# 检查 src 目录下 .js 和 .vue 文件的代码规范
npm run lint
# 运行单元测试,先清除缓存再执行测试
npm run test:unit
# 优化 src/assets/icons/svg 目录下的 SVG 文件
npm run svgo
# 使用 plop 创建新文件模板
npm run new
```
## 常见问题
1、linux 系统在安装依赖的时候会出现 node-sass 无法安装的问题
解决方案:
```
1. 单独安装:npm install --unsafe-perm node-sass
2. 直接使用:npm install --unsafe-perm
```
2、加速node-sass安装
https://www.ydyno.com/archives/1219.html
# cutejava-ui
## 前端模板
初始模板基于: [https://github.com/PanJiaChen/vue-element-admin](https://github.com/PanJiaChen/vue-element-admin)
模板文档: [https://panjiachen.github.io/vue-element-admin-site/zh/guide/](https://panjiachen.github.io/vue-element-admin-site/zh/guide/)
## 快速开始
#### 环境要求
**推荐 node 版本:16**
#### 安装依赖
``` bash
# 安装依赖(依赖python)
npm install --registry https://registry.npmmirror.com
```
#### 启动服务
```bash
# 启动服务 localhost:8013
npm run dev
# (或) 启动服务 localhost:8013
IDEA -> Current File -> Edit Configurations... -> Add New Configuration -> npm -> Script选dev -> Apply -> Ok
# 构建生产环境
npm run build:prod
# 本地预览生产环境
npm run preview
```
## 命令说明
#### 开发相关
```shell
# 启动本地开发服务器,默认端口 8013,支持热重载
npm run dev
# Windows 系统启动开发服务器,设置 OpenSSL 兼容性选项
npm run dev-win
# Linux 系统启动开发服务器,设置 OpenSSL 兼容性选项
npm run dev-linux
```
#### 构建相关
```shell
# 构建开发环境版本,输出到 dist 目录
npm run build:dev
# 构建预发布环境版本,输出到 dist 目录
npm run build:stage
# 构建生产环境版本,输出到 dist 目录
npm run build:prod
# 构建生产环境版本(无特定模式)
npm run build:production
```
#### 辅助命令
```shell
# 预览构建后的静态文件,启动本地服务器查看构建结果
npm run preview
# 检查 src 目录下 .js 和 .vue 文件的代码规范
npm run lint
# 运行单元测试,先清除缓存再执行测试
npm run test:unit
# 优化 src/assets/icons/svg 目录下的 SVG 文件
npm run svgo
# 使用 plop 创建新文件模板
npm run new
```
## 常见问题
1、linux 系统在安装依赖的时候会出现 node-sass 无法安装的问题
解决方案:
```
1. 单独安装:npm install --unsafe-perm node-sass
2. 直接使用:npm install --unsafe-perm
```
2、加速node-sass安装
https://www.ydyno.com/archives/1219.html