# 项目模板使用说明

本模板是基于 UniApp + Vue3 + TypeScript 的小程序项目模板，提供了一些常用的工具和规范。

## 目录结构

```
├── api/                   # 接口相关
│   ├── modules/           # 业务接口
│   └── request.ts         # 请求封装
├── common/                # 公共资源
│   ├── styles/            # 全局样式
│   │   ├── common.css     # codefun原子类样式
│   │   └── base.scss      # 全局样式变量
│   └── utils/             # 工具函数
│       └── tool.ts        # 常用工具函数
├── components/            # 公共组件
├── lib/                   # 第三方库
│   └── luch-request/      # luch-request 网络请求库
├── pages/                 # 主包页面
│   └── index/             # 首页
│       └── index.vue      # 首页页面
├── subPages/              # 分包页面
├── store/                 # 状态管理
│   └── index.ts           # Vuex store
├── uni_modules/           # uni-app 组件
│   └── z-paging/          # 分页组件库
├── uview-plus/            # uView-Plus 组件库
├── App.vue               # 应用入口
├── main.ts               # 主入口文件
├── pages.json            # 页面配置
├── manifest.json         # 应用配置
├── uni.scss              # 全局样式变量
├── vite.config.js        # Vite 编译配置
├── .env                  # 环境变量
├── .nvmdrc              # Node.js 版本要求
└── tsconfig.json         # TypeScript 配置
```

## 使用方法

1. 将模板目录复制到您的项目目录下
2. 根据需要修改 package.json 中的项目名称和描述
3. 使用 npm install 安装依赖
4. 根据需要修改 pages.json 中的页面配置
5. 开始开发新功能

## 项目重要配置说明

### 核心依赖包
- **UniApp**: 跨平台开发框架
- **Vue3**: 渐进式 JavaScript 框架
- **TypeScript**: JavaScript 超集，提供类型检查
- **uView-Plus**: UI 组件库
- **z-paging**: 分页组件
- **Vuex**: 状态管理
- **luch-request**: 网络请求库
- **dotenv**: 环境变量注入

### 样式

- common.css: 全局基础样式，包含codefun原子类
- base.scss: SCSS 变量和 mixins，提供常用的样式类生成器

### 工具函数 (tool.ts)

- alert: 文字轻提示
- loading/hideLoading: 显示/隐藏加载提示
- 页面跳转方法: navigateTo, redirectTo, reLaunch, switchTab, navigateBack
- 本地缓存操作: storage, removeStorage, getStorageInfo
- copy: 复制文本到剪贴板
- saveImageToPhotos: 保存图片到相册
- requestPayment: 微信支付
- upload: 文件上传
- loadFont: 加载外部字体

### 配置文件

- App.vue: 全局样式引入和基础设置
- main.ts: Vue 应用初始化和全局组件注册
- pages.json: 页面路由和窗口表现配置
- manifest.json: 应用配置（appid等）
- uni.scss: 全局 SCSS 变量
- .env: 环境变量配置
- vite.config.js: Vite 构建配置

## 开发注意事项

1. 实际项目开发中请根据需要修改或扩展功能函数
2. 项目中的配置可根据具体需求进行修改和替换
3. 请遵循项目中已有的代码规范和风格
4. 样式文件可参考项目中的规范进行编写
5. 网络请求统一使用 api/request.ts 中封装的 luch-request
6. 工具函数统一在 common/utils/tool.ts 中维护
7. 环境变量通过 .env 文件进行配置，构建时会自动替换 manifest.json 中的 appid