# UniApp 电商模板项目

**Repository Path**: deepcy/uniapp

## Basic Information

- **Project Name**: UniApp 电商模板项目
- **Description**: 这是一个基于Vue3+TypeScript的UniApp电商模板项目，提供完整的电商功能模块和开发基础设施。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-23
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UniApp 电商模板项目

![License](https://img.shields.io/badge/license-MIT-blue.svg)

这是一个基于Vue3+TypeScript的UniApp电商模板项目，提供完整的电商功能模块和开发基础设施。

## 功能特性

- 🛒 完整的电商功能（商品、购物车、订单、用户中心）

## 文档体系

### 技术文档

1. [技术架构](docs/TECHNICAL_ARCHITECTURE.md)
2. [核心模块](docs/CORE_MODULES.md)
3. [API接口](docs/API_DOCUMENTATION.md)

### 开发指南

1. [开发者指南](docs/DEVELOPER_GUIDE.md)
2. [配置管理](docs/CONFIGURATION.md)
3. [代码规范](docs/DEVELOPMENT.md)

### 其他

1. [资源管理](docs/ASSETS_GUIDE.md)
2. [测试指南](docs/TESTING.md)

### 快速配置示例

```bash
# 复制环境模板
cp .env.example .env.local

# 编辑配置
nano .env.local

# 启动开发服务器
npm run dev
```

### 图片资源要求

- 导航图标：50x50px PNG格式
- 商品图片：800x800px JPG格式
- 所有图片需小于100KB
- 提交时自动检查（pre-commit钩子）
- 📱 多端适配（H5、小程序、App）
- 🎨 现代化UI组件库
- ⚡ Vue3 + TypeScript + Pinia 技术栈
- 🔧 完善的开发工具链支持

## 项目结构

```bash
├── api                  # API接口管理
├── components           # 公共组件
├── pages                # 页面目录
│   ├── cart             # 购物车模块
│   ├── category         # 分类模块
│   ├── goods            # 商品模块
│   ├── index            # 首页模块
│   ├── login            # 登录注册模块
│   ├── order            # 订单模块
│   └── user             # 用户中心模块
├── static               # 静态资源
├── store                # 状态管理
├── utils                # 工具函数
├── .env.*               # 环境变量配置
└── vue.config.js        # Webpack配置
```

## 快速开始

### 环境准备

1. **Node.js**: v16.14.0+ (推荐使用nvm管理版本)

   ```bash
   nvm install 16.14.0
   nvm use 16.14.0
   ```

2. **HBuilderX**: 3.6.16+ (开发工具)

   - 下载地址: https://www.dcloud.io/hbuilderx.html

   - 安装后配置Node路径:

     ```
     菜单 → 工具 → 设置 → 运行配置 → Node运行路径
     ```

3. **Git**: 2.37.0+

   ```bash
   # macOS
   brew install git
   
   # Windows
   choco install git
   ```

4. 安装项目依赖:

   ```bash
   npm install
   ```

### 开发工作流

1. 启动开发服务器:

   ```bash
   npm run dev
   ```

2. 在HBuilderX中:

   - 导入项目
   - 选择运行到浏览器/小程序/App

3. 开发完成后:

   ```bash
   # 代码格式化
   npm run format
   
   # 代码检查
   npm run lint
   
   # 构建生产环境
   npm run build
   ```

### 代码提交规范

1. 提交前检查:

   ```bash
   npm run precommit
   ```

2. 提交消息格式:

   ```
   type(scope): description
   ```

   示例:

   ```
   feat(cart): 添加购物车动画效果
   fix(login): 修复验证码发送频率限制问题
   ```

## 贡献指南

1. Fork项目仓库
2. 创建特性分支 (`git checkout -b feature/xxx`)
3. 提交更改 (`git commit -am 'feat(xxx): add some feature'`)
4. 推送到分支 (`git push origin feature/xxx`)
5. 创建Pull Request

## 常见问题

Q: 运行时报错"Module not found"
A: 尝试删除node_modules后重新安装依赖

   ```bash
rm -rf node_modules
npm install
   ```

Q: HBuilderX无法识别项目
A: 确保项目目录结构完整，并检查HBuilderX版本

Q: 接口请求跨域问题
A: 配置代理或修改.env文件中的API地址

```bash
# 启动开发服务器
npm run dev

# 构建生产环境
npm run build

# 代码格式检查
npm run lint
```

## 配置说明

编辑 `.env` 文件配置环境变量：

```ini
VUE_APP_API_BASE_URL=http://api.example.com
VUE_APP_DEBUG=true
```

## 二次开发指南

1. 修改 `pages.json` 配置页面路由
2. 在 `src/api` 中添加API接口
3. 在 `src/store` 中管理全局状态
4. 在 `src/components` 中添加公共组件

## 许可证

MIT License





和我聊天微：cy321one

反馈邮箱：[samhoclub@163.com](mailto:samhoclub@163.com)

公众号：尘渊文化

官网：www.cycu.top

![img](https://pic1.zhimg.com/80/v2-77aed7e43dc44ddd627ef4ac285b8296_720w.png)