新增：全量优化

2025-11-05 16:20:06 +08:00
parent ca6bf7f211
commit 65656f1810
27 changed files with 2407 additions and 292 deletions
--- a/README.md
+++ b/README.md
@@ -1,80 +1,159 @@
-# <EFBFBD><EFBFBD>Ŀģ<EFBFBD><EFBFBD>ʹ<EFBFBD><EFBFBD>˵<EFBFBD><EFBFBD> 
- 
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><EFBFBD><EFBFBD>ǻ<EFBFBD><EFBFBD><EFBFBD> UniApp + Vue3 + uView-Plus <EFBFBD><EFBFBD>С<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀģ<EFBFBD>壬<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>һЩ<EFBFBD><EFBFBD><EFBFBD>õ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>á<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>͹<EFBFBD><EFBFBD>ߺ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
-  
-## Ŀ¼<EFBFBD>ṹ  
- 
- ```
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> api/                   # <EFBFBD>ӿ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> modules/           # ҵ<EFBFBD><EFBFBD><EFBFBD>ӿ<EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> request.js         # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>װ
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> common/                # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Դ
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> styles/            # ȫ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʽ
-<EFBFBD><EFBFBD>   <EFBFBD><EFBFBD>   <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> common.css     # codefunԭ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʽ
-<EFBFBD><EFBFBD>   <EFBFBD><EFBFBD>   <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> base.scss      # ȫ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʽ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> utils/             # <EFBFBD><EFBFBD><EFBFBD>ߺ<EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>       <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> tool.ts        # <EFBFBD><EFBFBD><EFBFBD>ù<EFBFBD><EFBFBD>ߺ<EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> components/            # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> uni_modules/           # uni-app <EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> z-paging/          # <EFBFBD><EFBFBD>ҳ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> lib/                   # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> luch-request/      # luch-request <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> uview-plus/            # uView-Plus <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> mixins/                # Vue <EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> global.ts          # ȫ<EFBFBD>ֻ<EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> store/                 # ״̬<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD>   <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> index.ts           # Vuex store
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> pages/                 # <20><><EFBFBD><EFBFBD>ҳ<EFBFBD><D2B3>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> subPages/              # <EFBFBD>ְ<EFBFBD>ҳ<EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> App.vue               # Ӧ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> main.js               # <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ļ<EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> pages.json            # ҳ<><D2B3><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> manifest.json         # Ӧ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> uni.scss              # ȫ<><C8AB><EFBFBD><EFBFBD>ʽ<EFBFBD><CABD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> vite.config.js        # Vite <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> .nvmdrc              # Node.js <20>汾Ҫ<E6B1BE><D2AA>
-<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> .env                  # <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
-```
- 
-## ʹ<>÷<EFBFBD><C3B7><EFBFBD> 
- 
-1. <EFBFBD><EFBFBD><EFBFBD><EFBFBD>ģ<EFBFBD><EFBFBD>Ŀ¼<EFBFBD><EFBFBD><EFBFBD>Ƶ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ĿĿ¼<EFBFBD><EFBFBD> 
-2. <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ҫ<EFBFBD>޸<EFBFBD> package.json <20>е<EFBFBD><D0B5><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD>ƺ<EFBFBD><C6BA><EFBFBD><EFBFBD><EFBFBD> 
-3. ʹ<EFBFBD><EFBFBD> npm install <20><>װ<EFBFBD><D7B0><EFBFBD><EFBFBD> 
-4. <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ҫ<EFBFBD>޸<EFBFBD> pages.json <20>е<EFBFBD>ҳ<EFBFBD><D2B3><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
-5. <20><>ʼ<EFBFBD><CABC><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>¹<EFBFBD><C2B9><EFBFBD> 
- 
-## <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ҫ<EFBFBD><D2AA><EFBFBD><EFBFBD> 
-
-### <20><>Ҫ<EFBFBD><D2AA><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
- **dotenv** - <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ע<EFBFBD><D7A2>
- 
-### <20><>ʽ 
- 
- common.css: ȫ<>ֻ<EFBFBD><D6BB><EFBFBD><EFBFBD><EFBFBD>ʽ 
- base.scss: <20><><EFBFBD>õ<EFBFBD> SCSS <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- 
-### <20><><EFBFBD>ߺ<EFBFBD><DFBA><EFBFBD> (tool.js) 
- 
- alert: <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʾ 
- loading/hideLoading: <20><>ʾ/<2F><><EFBFBD>ؼ<EFBFBD><D8BC><EFBFBD><EFBFBD><EFBFBD>ʾ 
- ҳ<><D2B3><EFBFBD><EFBFBD>ת<EFBFBD><D7AA><EFBFBD>ط<EFBFBD><D8B7><EFBFBD>: navigateTo, redirectTo, reLaunch, switchTab, navigateBack 
- <20><><EFBFBD>ػ<EFBFBD><D8BB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>: storage, removeStorage, getStorageInfo 
- copy: <20><><EFBFBD><EFBFBD><EFBFBD>ı<EFBFBD><C4B1><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- saveImageToPhotos: <20><><EFBFBD><EFBFBD>ͼƬ<CDBC><C6AC><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- requestPayment: ΢<><CEA2>֧<EFBFBD><D6A7> 
- upload: <20>ļ<EFBFBD><C4BC>ϴ<EFBFBD> 
- 
-### <20><><EFBFBD><EFBFBD> 
- 
- App.vue: ȫ<><C8AB><EFBFBD><EFBFBD>ʽ<EFBFBD><CABD><EFBFBD><EFBFBD><EFBFBD>ͻ<EFBFBD><CDBB><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- main.js: Vue Ӧ<>ó<EFBFBD>ʼ<EFBFBD><CABC><EFBFBD><EFBFBD>ȫ<EFBFBD>ֲ<EFBFBD><D6B2><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- pages.json: ҳ<><D2B3>·<EFBFBD>ɺʹ<C9BA><CDB4><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- uni.scss: ȫ<><C8AB><EFBFBD><EFBFBD>ʽ<EFBFBD><CABD><EFBFBD><EFBFBD> 
- 
-## ע<><D7A2><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
- 
-1. <20><><EFBFBD><EFBFBD>ʵ<EFBFBD><CAB5><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 
-2. <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD><EFBFBD><EFBFBD>޸Ļ<DEB8><C4BB><EFBFBD>չ<EFBFBD><D5B9><EFBFBD>ߺ<EFBFBD><DFBA><EFBFBD> 
-3. <20><><EFBFBD><EFBFBD><EFBFBD>ɸ<EFBFBD><C9B8><EFBFBD><EFBFBD><EFBFBD>Ҫ<EFBFBD><D2AA><EFBFBD><EFBFBD><EFBFBD>޸Ļ<DEB8><C4BB>滻 
-4. <20><>ʽ<EFBFBD>ļ<EFBFBD><C4BC>ɸ<EFBFBD><C9B8><EFBFBD><EFBFBD><EFBFBD>Ŀ<EFBFBD><C4BF><EFBFBD>ƹ淶<C6B9><E6B7B6><EFBFBD>е<EFBFBD><D0B5><EFBFBD> 
+# UniApp 微信小程序快速开发模板
+
+本模板是基于 UniApp + Vue3 + uView-Plus 的微信小程序项目模板，提供了一些常用的工具函数、组件和最佳实践。
+
+## 目录结构
+
+```
+├── api/                   # 接口相关
+│   ├── modules/           # 业务接口
+│   └── request.js         # 请求封装
+├── common/                # 公共资源
+│   ├── styles/            # 全局样式
+│   │   ├── common.css     # codefun原子类样式
+│   │   └── base.scss      # 全局样式变量
+│   └── utils/             # 工具函数
+│       └── tool.js        # 常用工具函数
+├── components/            # 公共组件
+├── uni_modules/           # uni-app 组件
+│   └── z-paging/          # 分页组件库
+├── lib/                   # 第三方库
+│   └── luch-request/      # luch-request 网络请求库
+├── uview-plus/            # uView-Plus 组件库
+├── mixins/                # Vue 混入
+│   └── global.js          # 全局混入
+├── store/                 # 状态管理
+├── pages/                 # 主包页面
+├── subPages/              # 分包页面
+├── App.vue               # 应用入口
+├── main.js               # 主入口文件
+├── pages.json            # 页面配置
+├── manifest.json         # 应用配置
+├── uni.scss              # 全局样式变量
+├── vite.config.js        # Vite 编译配置
+├── .nvmdrc              # Node.js 版本要求
+└── .env                  # 环境变量
+```
+
+## 使用方法
+
+1. 将模板目录复制到你的项目目录中
+2. 根据需要修改 package.json 中的项目名称和描述
+3. 使用 npm install 安装依赖
+4. 根据需要修改 pages.json 中的页面配置
+5. 开始构建你的新项目
+
+## 开发环境与运行
+
+### 环境要求
+
+* Node.js (版本信息在 `.nvmdrc` 文件中指定，当前为 20.0.0)
+* npm 或 yarn
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 运行项目
+
+由于这是一个 UniApp 项目，通常需要使用 HBuilderX 或其他支持 UniApp 的 IDE 来运行和调试。具体的运行命令取决于你的开发环境。
+
+### 构建项目
+
+同样，构建项目也需要使用 HBuilderX 或相应的 CLI 工具。
+
+## 项目特性
+
+### 核心依赖
+- **dotenv** - 环境变量注入
+
+### 样式系统
+
+- common.css: 全局原子类样式
+- base.scss: 实用的 SCSS 工具类
+
+### 工具函数 (tool.js)
+
+- alert: 文字轻提示
+- loading/hideLoading: 显示/隐藏加载提示
+- 页面跳转方法: navigateTo, redirectTo, reLaunch, switchTab, navigateBack
+- 本地存储: storage, removeStorage, getStorageInfo
+- copy: 复制文本到剪贴板
+- saveImageToPhotos: 保存图片到相册
+- requestPayment: 微信支付
+- upload: 文件上传
+- formatDate: 日期格式化
+- deepClone: 深拷贝
+- debounce/throttle: 防抖节流
+- getValidator: 表单验证工具
+- toggleDarkMode/getCurrentTheme: 暗黑模式切换
+
+### 网络请求
+
+- 基于 luch-request 的封装
+- 自动添加 token
+- 统一错误处理
+- 请求缓存机制
+- 请求重试机制
+
+### 组件
+
+- uView-Plus 组件库
+- z-paging 分页组件
+
+## 代码规范与开发约定
+
+### 样式
+
+- 全局样式文件位于 `common/styles/` 目录下
+- 遵循项目中已有的风格
+
+### JavaScript
+
+- 严格遵循ES6规范
+- 遵循JavaScript函数式编程范式
+- 方法类函数应该使用 `function` 进行定义
+- 页面的生命周期需要通过 `@dcloudio/uni-app` 依赖进行按需导入
+- 全局变量都集中放置于代码顶部
+- 变量名使用小驼峰命名法
+- 常量名使用全大写
+- 所有 `Promise` 类方法使用 `async` `await` 写法
+- 在需要页面跳转、提示、加载、本地存储等功能的时候，优先使用工具函数
+- 字符串拼接使用ES6的模板语法
+
+### 静态资源
+
+- 静态资源变量 `ASSETSURL` 已进行全局混入，可以在 `<template></template>` 中直接使用
+
+### 网络请求
+
+- 网络请求使用 `lib/luch-request` 库进行封装
+- 包含请求和响应拦截器，用于处理通用逻辑
+- 各业务板块的接口都应存放在 `api/modules` 下
+
+### 组件
+
+- 所有 `uni_modules` 目录中的组件无需导入直接可以进行使用
+- `uView-Plus` 组件已通过 `easycom` 自动导入
+
+### 页面
+
+- 页面配置在 `pages.json` 中管理
+- 页面使用 Composition API (setup语法糖) 编写
+
+## 代码提交规范
+
+- 提交信息应清晰描述变更内容
+- 对于功能性的新增或修改，使用 `新增` 前缀
+- 对于错误修复，使用 `修复` 前缀
+- 对于性能优化、代码重构，使用 `优化` 前缀
+- 对于文档更新，使用 `文档` 前缀
+- 提交信息应使用中文
+
+## 注意事项
+
+1. 请根据实际项目需求进行修改和扩展功能
+2. 代码文件可按项目规范进行修改替换
+3. 样式文件可按项目规范进行修改