/tags/scaffolding/ Recent content in scaffolding on Hugo -- gohugo.io en Tue, 21 Apr 2026 10:00:00 +0800 /posts/maven-archetype-from-existing-project/ Tue, 21 Apr 2026 10:00:00 +0800 /posts/maven-archetype-from-existing-project/ 背景 一个团队维护多个 Spring Boot 服务时，常见的痛点是： 每个新服务都要从头抄一遍 pom.xml、application.yaml、logback-spring.xml、Dockerfile、Makefile…… 抄着抄着就出现"A 服务用了新的 actuator 配置，B 服务还是旧的"这种偏差。 Onboarding 新成员时，“我要建个新服务"变成一个需要问老人、翻三个仓库的事情。 一个比较务实的解决方式：从现有的成熟项目里，抽象出 Maven Archetype。以后建新服务直接： mvn archetype:generate \ -DarchetypeGroupId=com.example \ -DarchetypeArtifactId=my-service-archetype \ -DarchetypeVersion=1.0.0 \ -DgroupId=com.example \ -DartifactId=order-service \ -Dversion=0.0.1-SNAPSHOT 一条命令生出一个带完整脚手架的新项目。 本文记录从零做一个 Archetype 的完整流程，包括最容易踩坑的 Velocity 转义。 两种制作方式 方式一：archetype:create-from-project Maven 官方提供了自动生成脚本： cd my-reference-project mvn archetype:create-from-project 它会在 target/generated-sources/archetype/ 下生成一个 archetype 项目骨架。 适合场景：现有项目结构很干净、大部分文件都能直接复用。 缺点： 会把业务代码一并塞进 archetype-resources/，还得手动挑。 所有 ${...} 都会被机械地替换，不区分是"用户可配置的变量"还是"Spring 运行时占位符”。 生成后还是要大改一轮，不如一开始就手写。 方式二：手工制作 自己按约定的目录结构搭一个 archetype 项目，把模板文件逐个放进去。 适合场景：需要抽象多个现有项目的共同部分，或者想要一次做多个不同形态的 archetype（比如 gateway、BFF、domain service 各一个）。 下文以手工制作为主。 Archetype 项目结构 一个最小可用的 archetype 项目长这样：