NideShop 商城微信小程序端：导入与后端 API 配置指南

一、项目官方信息

NideShop 商城（微信小程序端） 是一套开源微信小程序商城前端，界面高仿网易严选商城（主要是 2016 年 wap 版），测试数据采集自网易严选商城，功能和数据库参考 ecshop。

特点：

• 服务端 API 基于 Node.js + ThinkJS + MySQL；
• 功能覆盖首页、分类、商品、购物车、下单支付、会员中心；
• 注意：当前版本功能还未完善，请勿商用。

二、官方图片

上图为 NideShop 仓库在 GitHub 上的社交预览图。README 中另附首页、专题、分类、商品列表、商品详情、购物车、订单中心等多张小程序界面截图。

三、环境要求

• 微信开发者工具（最新稳定版）。
• 配套服务端：Node.js 运行环境 + MySQL（即 tumobi/nideshop）。
• 小程序 AppID（在微信公众平台申请）。

四、部署步骤

1. 先启动配套服务端 API

本小程序必须配合 NideShop 服务端使用。按 tumobi/nideshop 的说明，用 Node.js + MySQL 把服务端跑起来，记下它对外提供的 API 地址（如 http://你的服务器端口）。

2. 下载小程序端代码

git clone https://github.com/tumobi/nideshop-mini-program.git

3. 导入微信开发者工具

• 打开微信开发者工具，选择「导入项目」；
• 目录选择刚克隆的 nideshop-mini-program；
• 填写自己的小程序 AppID。

4. 配置后端 API 地址

在项目配置里把请求基地址指向你部署的 NideShop 服务端 API（修改 config 目录中的 API 地址配置）。本地调试时，在开发者工具「详情 → 本地设置」中勾选「不校验合法域名、web-view、TLS 版本以及 HTTPS 证书」。

5. 编译预览

点击「编译」即可在模拟器预览；也可点「预览」用手机扫码真机调试（手机需开启调试模式）。

五、使用方法

按 README 功能列表，前端包含：

• 首页：轮播、推荐商品、专题入口；
• 分类：分类首页、分类商品、新品首发、人气推荐；
• 商品详情：加入购物车、收藏、商品评论；
• 搜索：关键词搜索；
• 专题/品牌：专题列表与详情、品牌列表与详情；
• 购物流程：加入、编辑、删除、批量选择购物车商品，选择收货地址，下单支付；
• 会员中心：订单、收藏、足迹、收货地址、意见反馈。

六、常见问题 FAQ

1. 导入后接口请求失败？ 先确认服务端 NideShop API 已启动且可访问；本地调试时在开发者工具勾选「不校验合法域名」。

2. 这个小程序可以直接商用吗？ README 明确提示「当前版本功能还未完善，请勿商用」，学习与二次开发可以。

3. 后端必须用什么技术栈？ 配套服务端是 Node.js + ThinkJS + MySQL，见 tumobi/nideshop。

4. 微信登录、支付怎么用不了？ 最简启动只跑通浏览/下单流程；微信登录、微信支付需在小程序后台与服务端配置 AppID、商户号等，详见服务端文档。

5. 项目目录结构是怎样的？ pages 下按业务模块组织（auth、brand、cart、catalog、goods、topic、ucenter 等），config 放配置，utils 放工具，lib/wxParse 用于富文本解析。

6. 数据从哪来？ 测试数据来自网易严选采集，正式使用需替换为自己的商品数据。

七、跳转链接

• GitHub 仓库：https://github.com/tumobi/nideshop-mini-program
• 配套服务端：https://github.com/tumobi/nideshop