如何使用Fitten Code自动生成Spring Boot Starter启动器代码

Fitten Code 可自动生成标准 Spring Boot Starter 工程，支持一键创建多模块结构、自动配置类、配置属性类及测试类，并提供本地安装或 JAR 引用两种集成方式。

想快速搭建一个可复用的 Spring Boot Starter？过去，你需要手动配置 META-INF/spring.factories、编写自动配置类、条件注解，还得操心依赖管理，一套流程走下来，效率确实不高。以我实际体验来说，Fitten Code 能根据你输入的模块名和功能描述，直接生成结构完整、开箱即用的 Starter 工程代码，省去重复创建包结构、编写 @ConfigurationProperties 和 EnableAutoConfiguration 的繁琐过程。

安装并启动 Fitten Code 插件

操作很简单：直接在 IntelliJ IDEA 中打开 Settings（Windows）或 Preferences（macOS），进入 Plugins 搜索 "Fitten Code"，点击 Install，重启 IDE 就完事了。

重启后，注意右下角状态栏，如果出现绿色的 Fitten Code Ready 提示，说明插件已经激活。要是没看到，记得检查是否登录了 Fitten Code 账户，并确保 API Key 绑定成功。

新建 Starter 项目模板

从菜单中选择 File → New → Project → Fitten Code → Spring Boot Starter Template，进入配置窗口。

在这里，你需要填写 Group ID（比如 com.example）、Artifact ID（比如 my-redis-starter）、Starter 名称（比如 Redis AutoConfigure Starter），以及简要的功能描述——例如“自动装配 RedisTemplate 并支持 YAML 配置超时与数据库索引”。

注意：Artifact ID 必须以 -starter 结尾，否则生成的 pom.xml 不会被 Spring Boot 识别为 Starter，这是个容易踩的坑。

点击 Create，IDE 会自动生成包含 starter-module、autoconfigure-module、sample-demo 三个模块的标准多模块工程，省去手动搭建的负担。

生成核心自动配置代码

接下来是关键——生成核心代码。我通常这样做：右键点击 autoconfigure-module，选择 Open in Terminal，然后执行一条命令：

fitten-code generate starter-config --name RedisAutoConfiguration --props RedisProperties

这条命令会帮你自动创建：

• RedisProperties 类（带 @ConfigurationProperties(prefix = "my.redis")）
• RedisAutoConfiguration 类（带 @ConditionalOnClass(RedisTemplate.class) 和 @Bean 方法）
• 测试类 RedisAutoConfigurationTests

不过，我自己实际测试下来，有个细节特别值得注意：生成后立即检查 RedisProperties 中的字段类型是否匹配你的需求。比如 timeout 字段默认是 Long，但如果你需要支持 "30s" 这样的字符串解析，必须手动添加 @DurationUnit(ChronoUnit.SECONDS) 注解，否则运行时会报错。这个提前补一下能省很多排查时间。

注入自定义 Starter 到现有项目

如果要说哪里最体现这个 Starter 的实用性，那一定是注入到现有项目的环节。这里有两种常用方式：

方法一：Ma ven 本地安装——在 starter-module 目录下执行 mvn clean install，然后回到你的目标 Spring Boot 项目，在 pom.xml 的 中加上依赖即可：

com.example
my-redis-starter
1.0.0

方法二：IDEA 内直接引用——右键目标项目 → Module Settings → Dependencies → 点击 + → JARs and directories → 选中 starter-module/target/my-redis-starter-1.0.0.jar。

最后，别忘了在 application.yml 中加上配置：my.redis.host=localhost。启动应用时，观察控制台是否输出 "RedisAutoConfiguration matched" 日志，这一步能帮你确认自动配置是否生效。