# spring-cloud-learning

**Repository Path**: dmouse6/spring-cloud-learning

## Basic Information

- **Project Name**: spring-cloud-learning
- **Description**: # SpringCloud 学习仓库

本仓库用于系统学习 SpringCloud 微服务相关知识。

内容包括：
- SpringBoot 基础
- SpringCloud 组件学习
- 中文注释 + 学习笔记
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-25
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# spring-cloud-learning
## 介绍
SpringCloud 微服务系统化学习仓库，本项目基于 `SpringBoot + Spring Cloud Alibaba` 技术栈从零搭建，采用 **Maven 父子多模块聚合架构**，专为微服务入门学习、技术实践、知识点沉淀打造。

本仓库循序渐进落地微服务核心知识点，覆盖基础框架使用、主流中间件整合、服务治理、数据库实操、接口开发等核心内容；
所有业务代码、配置类、启动类均配备**详细中文注释 + 配套学习笔记**，逻辑清晰、结构规范，方便日常学习、复盘总结与后期拓展迭代。

## 软件架构
### 1. 工程模式
采用**父工程聚合 + 子服务独立自治**架构：
- 父模块仅负责项目统一收纳与规范管理，不参与任何业务逻辑；
- 各个微服务子模块完全解耦，各自独立管理依赖、版本、配置与业务代码；
- 支持独立开发、独立启动、独立打包、独立部署，贴合企业真实微服务拆分思想。

### 2. 核心技术栈
- 基础框架：SpringBoot 2.7.x
- 微服务体系：Spring Cloud Alibaba
- 服务治理：Nacos（服务注册、服务发现）
- 数据存储：Docker 容器化 MySQL 8.0
- 持久层框架：MyBatis
- 辅助工具：Lombok、Maven、Docker

### 3. 设计思想
- 遵循单一职责，按业务维度垂直拆分微服务；
- 经典三层架构：Controller / Service / Mapper 分层清晰；
- 编码规范统一，轻量化易上手，侧重实战学习。

## 学习内容
- SpringBoot 基础：自动配置、常用注解、项目分层、配置文件使用
- 微服务核心：Nacos 搭建、服务注册、服务发现、多模块协同
- 数据库实操：Docker 部署 MySQL、自定义业务表设计、CRUD 开发
- 分布式基础：微服务拆分理念、服务解耦、中间件整合
- 工程实战：接口开发、业务封装、环境搭建、标准化开发流程

## 安装教程
1. 环境准备
   本地配置 JDK、Maven、Docker 基础环境；
   使用 Docker 快速部署 Nacos、MySQL8.0 等中间件。
2. 项目拉取
   克隆本仓库，使用 IDEA 导入 Maven 工程，等待依赖加载完成。
3. 配置修改
   修改各子服务 `yml` 配置，适配本地 Nacos、MySQL 连接信息。
4. 数据初始化
   执行项目内置 SQL 脚本，创建业务数据库与数据表。

## 使用说明
1. 提前启动 Nacos、MySQL 等容器中间件；
2. 按需启动单个/多个微服务，自动注册至 Nacos 注册中心；
3. 测试接口功能，结合代码注释理解微服务核心流程；
4. 可自由新增业务模块、拓展功能，持续迭代学习。

## 参与贡献
1. Fork 本仓库
2. 新建功能分支：`Feat_xxx` / `Fix_xxx`
3. 提交代码并完成自测
4. 提交 Pull Request 等待合并

## 后续规划
后续持续更新：服务远程调用、Nacos配置中心、网关、熔断降级、分布式事务等进阶内容，逐步完善整套微服务与分布式技术体系。