文章目录一、概述二、前置知识要求三、开发环境搭建与工具准备3.1 JDK 1.8 安装与配置3.2 Maven 3.6+ 安装与配置3.3 IntelliJ IDEA 安装与配置3.4 Node.js 16+ 安装与配置3.5 MySQL 5.7/8.0 安装3.6 Redis 安装与配置3.7 HBuilderX 与微信开发者工具3.8 Git 安装与基本配置3.9 环境验证清单四、项目架构设计与技术选型解析4.1 项目全景概览4.1.1 项目定位4.1.2 四个子项目4.1.3 仓库目录结构4.1.4 系统架构图4.2 后端技术栈深度解析4.2.1 核心框架版本一览4.2.2 Spring Boot 2.3.x 选型理由4.2.3 MyBatis-Plus vs 纯 MyBatis4.2.4 Shiro + JWT 选型对比4.3 Maven 多模块架构设计4.3.1 模块依赖关系4.3.2 父 POM 版本管理策略4.3.3 多环境 Profile 切换4.3.4 wind-common 公共模块详解4.3.5 bootstrap 启动模块4.4 三端分离架构详解4.4.1 URL 前缀隔离策略4.4.2 共享 Service 层4.4.3 各端 Controller 示例4.5 后端分层架构详解4.5.1 四层架构模型4.5.2 请求处理完整链路4.5.3 统一返回格式 ApiResult4.6 前端架构设计4.6.1 管理端/店铺端架构（Vue 3 + Vite + Element Plus）4.6.2 移动端架构（uni-app + Vue 3）4.7 核心能力一览4.8 设计模式在项目中的应用工厂模式 — 文件存储策略模式 — Shiro 过滤链模板方法模式 — BaseController/BaseService五、常见问题解答Q1：`java` 不是内部或外部命令Q2：Maven 下载依赖很慢或超时Q3：Node.js 版本过低导致 npm install 报错Q4：MySQL 安装后无法连接Q5：Redis 连接被拒绝Q6：为什么不用 Spring Boot 3.x + JDK 17？Q7：三端为什么不用微服务拆分？Q8：为什么管理端和店铺端分开两套前端？Q9：为什么要用 JWT 而不是 Session？Q10：app_id 多租户隔离是怎么实现的？六、实践练习与检验标准练习1：环境自检练习2：MySQL 数据库准备练习3：IDEA 项目导入测试练习4：绘制模块依赖图练习5：追踪一个 API 请求练习6：对比三端 Controller练习7：模块代码量统计七、总结一、概述在电商系统开发领域，一套设计良好、文档齐全的开源项目是快速入门的绝佳教材。wind Shop是一套面向开发与二次开发友好的单商户开源电商系统，提供从商品管理、订单处理、会员营销到数据统计的全流程业务能力，具备三端分离（管理端 admin、店铺端 shop、移动端 front）、多端发布（微信小程序、H5、支付宝/微信/字节/百度小程序、Android/iOS App）等核心特征。本教程覆盖开发环境搭建和系统架构设计两大板块，学完后你将对电商系统的技术全貌形成清晰认知。二、前置知识要求基本的计算机操作能力（文件管理、命令行使用）了解 Windows 系统环境变量概念了解 Java Web 开发基本概念（Servlet、Spring IoC/DI）了解 RESTful API 和前端 MVVM 框架基本概念建议 8GB 以上内存的电脑（推荐 16GB）三、开发环境搭建与工具准备3.1 JDK 1.8 安装与配置wind Shop 使用Java 8（JDK 1.8），这是 Spring Boot 2.3.x 的稳定运行版本。下载：访问