# v-shop

**Repository Path**: joeshu/v-shop

## Basic Information

- **Project Name**: v-shop
- **Description**: 🛒 v-shop 是一个移动端 H5 商城
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: v3
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 76
- **Forks**: 25
- **Created**: 2020-02-08
- **Last Updated**: 2025-09-12

## Categories & Tags

**Categories**: ecommerce

**Tags**: None

## README

# v-shop

## 🌈 简介

v-shop 是一个前端免费开源的企业级移动端（H5）商城，使用 `vue3` `typescript` `vite` `vant` 等前端前沿技术开发，也可用于学习参考。

## ✨ 特性

- 💪 使用前端主流技术栈搭建
- 🍭 使用 [api 工厂](https://www.it120.cc/) 提供的开放 API 接口
- 🍭 [Vant](https://github.com/youzan/vant) 设计风格，支持 Vue 2、Vue 3
- 🍭 清晰的[项目结构](https://github.com/JoeshuTT/v-shop/blob/v3/DIRECTORY.md)，业务代码的最佳实现
- 🍭 使用 [TypeScript](https://github.com/microsoft/TypeScript) 开发
- 🍭 使用 [AlloyTeam ESLint](https://github.com/AlloyTeam/eslint-config-alloy) 规则， 规范项目代码
- 🍭 支持页面栈导航体验，使用 [vue-page-stack-router](https://github.com/JoeshuTT/vue-page-stack-router)实现
- 🎨 支持动态切换主题，支持动态加载移动端调试面板（vconsole、eruda），支持获取设备信息

## 🔥 预览

- :tada: v2 [Vue 2 + Vue CLI 4.5](https://v-shop.shuzp.top/v2/)
- :rocket: v3 [Vue 3 + Vite 2](https://v-shop.shuzp.top/)

## 🛠️ 产品

- 版本：v3
- 前端：vueJs + Vant
- 后端：[api 工厂](https://www.it120.cc/)
- 运行平台：移动端 H5
- 设计稿画布尺寸：375x667
- 文档资源整理: [《v-shop 知识库 —— 语雀》](https://www.yuque.com/vshop/)
- 商品模拟数据源： [小米商城](https://m.mi.com/)
- 已实现功能清单

  ```
  ├─登录注册
  ├─Tabbar
  ├─个人资料
  ├─主题(暗黑、配色)
  ├─优惠券
  ├─售后
  ├─商品
  ├─商品分类
  ├─异常
  ├─收货地址
  ├─积分
  ├─订单
  ├─购物车
  └─钱包
  ```

## 🔨 使用

> [Node.js](https://nodejs.org/) 版本需要在 `16.x` 以上

获取项目代码

```bash
# 通过 github 拉取（最新）
git clone https://github.com/JoeshuTT/v-shop.git

# 或者 gitee（国内）
git clone https://gitee.com/Joeshu/v-shop.git

# 进入项目目录
cd v-shop
```

安装依赖

```bash
# 通过 pnpm 安装
pnpm install
```

本地运行

```bash
pnpm run dev
```

打包发布

```bash
pnpm run build
```

## 💎 Changelog

- [主要改动](https://github.com/JoeshuTT/v-shop/blob/v3/CHANGELOG.md)

## ⭐ 作者

如果觉得项目不错，或者有帮助到你，希望你可以去 Github 或者 Gitee 帮我点个 ⭐ Star，这将是对我极大的鼓励与支持。

微信不加蟹蟹，有疑问加 qq 群：262053992 问。

## 📃 开源协议

v-shop 遵循 [MIT 协议](https://github.com/JoeshuTT/v-shop/blob/v3/LICENSE)。