快速开始

把整个 graceful-code-workshop 在本地跑起来只需要 3 步，全程不超过 5 分钟（首次依赖下载除外）。

环境要求

• JDK 17+
• Maven 3.6+

启动步骤

# 1. 克隆仓库
git clone <repo-url>
cd graceful-code-workshop

# 2. 编译并安装框架核心到本地 Maven 仓库
cd forge
mvn clean install

# 3. 启动主业务模块
cd ../forge-samples/forge-samples-boot
mvn spring-boot:run

启动成功后控制台会打印类似日志：

INFO  c.x.f.d.runner.DdlInitializer - Scanning models, packages=[...]
INFO  c.x.f.d.runner.DdlInitializer - Scan completed, N model(s) registered
...
Started Application in X.X seconds

访问入口

入口	地址
项目首页	http://localhost:18080/
Swagger UI	http://localhost:18080/swagger-ui.html
Knife4j UI	http://localhost:18080/doc.html
OpenAPI JSON	http://localhost:18080/v3/api-docs

常见问题

• Maven 编译失败提示找不到 forge-*：先到 forge/ 目录 mvn clean install，再回 forge-samples/ 启动
• Lombok 注解不生效：在 IDE 中安装 Lombok 插件并开启「Enable annotation processing」
• 端口被占用：修改 forge-samples-boot/src/main/resources/application.yml 中的 server.port

下一步

• forge-ddl 自动建表模块文档 —— 当前工坊最完整的一份模块文档
• 前置知识 —— 反射 / Spring 包扫描 / Spring Boot 启动钩子等通用概念扫盲