Maven Archetype 多 Module 自定义代码脚手架
发布时间：2025-11-03 01:29:47 来源：创站工坊 作者：应用开发
大部分公司都会有一个通用的多M定义代码模板项目，帮助你快速创建一个项目。脚手架通常，多M定义代码这个项目需要集成一些公司内部的脚手架中间件、单元测试、多M定义代码标准的脚手架代码格式、通用的多M定义代码代码分层等等。
今天，脚手架就利用 Maven 的多M定义代码 Archetype 插件来简单实现这一功能。
通过上面的脚手架图很清楚可以看到，实际利用这个插件机制就简单的多M定义代码几个步骤：
archetype:create-from-project ，根据自己的脚手架项目代码生成原型项目
通过 install 等命令生成原型文件
archetype:generate，通过原型生成目标项目
看起来挺简单的多M定义代码，但是脚手架你会发现你用网上搜到的资料来玩的话，你生成的多M定义代码项目特别傻X，包括官方的文档，我也真是没搞明白他们为何那么牛逼，一步两步。。WordPress模板就他妈好了?
一堆问题，比如 module 名称不会变、包名变了代码中没变，依赖报错一大堆问题，还是有必要说下中间要怎么做的。
创建Archetype
首先，准备好我们自己的模板项目，保证代码都是OK的。
进入项目根目录，执行命令：
mvn archetype:create-from-project然后项目根目录下会生成target文件夹，这个很简单，不会有任何障碍，你看下面的图，注意看每个模块的名字，这是我改过的!!
你生成应该会发现他不长这样，这就是问题啊!接着往下看吧。
这里最核心的部分就在于怎么修改target/generated-sources/src/main/resources/archetype-resources下的文件。
如果不修改直接继续的话，最终生成的项目会发现module的源码下载名称不会变，包名也不会变，代码里引用的会有一堆报错。
接着，我们看看咋改的，这一堆破问题。
修改父pom
首先，找到根目录的pom文件，会发现缺少module信息，这个必须加上。
<modules> <module>${rootArtifactId}-client</module> <module>${rootArtifactId}-common</module> <module>${rootArtifactId}-service</module> <module>${rootArtifactId}-facade</module> <module>${rootArtifactId}-starter</module> </modules>父pom依赖引用的每个module也要修改，groupId 和 artifactId 按照我给出的方式来改，不要写死!!
<dependencyManagement> <dependencies> <dependency> <groupId>${groupId}</groupId> <artifactId>${rootArtifactId}-client</artifactId> <version>${project.version}</version> </dependency> ... ... </dependencies> </dependencyManagement>修改module
这个就是图中的问题，默认生成的module可能就是模板项目的名字，需要修改成类似__rootArtifactId__-client这种形式，注意是双下划线。
然后module中的互相引用 groupId 和 artifactId 按照父 pom 的方式对应修改。
archetype-metadata 修改
找到META-INF/maven/archetype-metadata.xml文件，修改modules相关的部分，b2b信息网重点注意看 id 、dir、name 的修改方式。
<modules> <module id="${rootArtifactId}-client" dir="__rootArtifactId__-client" name="${rootArtifactId}-client"> <fileSets> <fileSet filtered="true" packaged="true" encoding="UTF-8"> <directory>src/main/java</directory> <includes> <include>**/*.java</include> </includes> </fileSet> </fileSets> </module> ... ... </modules>修改完成之后，进入 target/generated-sources/archetype目录，执行命令：
mvn install顺便执行下mvn deploy上传到nexus。
使用Archetype
经过上面的步骤，原型 Archetype 已经创建完成，其实最大的坑也就是上面那部分，花了老半天时间，简直坑爹啊。
下面看看怎么使用吧，两种使用方式。
命令行
随便进入你想保存项目的路径，执行命令。
mvn archetype:generate -DarchetypeCatalog=local依次按照提示输入 groupId、artifactId 即可完成创建。
那怎么给其他人使用?
你的本地maven仓库目录(比如~/.m2/repository)有一个文件archetype-catalog.xml，共享给其他人就行了。
<?xml version="1.0" encoding="UTF-8"?> <archetype-catalog xsi:schemaLocation="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0 http://maven.apache.org/xsd/archetype-catalog-1.0.0.xsd" xmlns="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <archetypes> <archetype> <groupId>com.example</groupId> <artifactId>template-archetype</artifactId> <version>1.0.0-SNAPSHOT</version> <description>Example Project</description> </archetype> </archetypes> </archetype-catalog>IDEA
新建项目，选择 Maven，勾选 Create from archetype，选择 Add Archetype...
接着，输入我们自定义的 Archetype 的 GroupId、ArtifactId、Version 信息。
Add 成功之后就可以在列表中看到我们自己的 archetype，然后按照流程创建即可。
- 电脑开机不出密码错误的原因与解决方法（探究密码错误问题及有效解决方案）
- 手机进水的正确补救步骤（急救指南，手机救命大作战）
- 电信170（畅享高品质通信服务，为您提供全方位沟通体验）
- 如何安装煎教程到硬盘上（详细步骤教你将煎教程安装到硬盘上）
- 从零开始学习机械师DOS装系统教程（掌握DOS装系统，轻松解决电脑问题）
- 联想手机ZUK系列（全面升级，体验超乎想象）
- 新华人寿IT发展情况分析（IT技术在新华人寿的应用及发展前景探索）
- 以移动送A3手机，你值得拥有！（了解A3手机的特点与优势，让你无懈可击）
- 电脑表格显示格式错误及解决方法（解析电脑表格显示错误的常见问题和解决方案）
- 探索精灵雷神K8的魅力（一款引人入胜的游戏设备）
- 电脑键盘打字手势教程（掌握打字手势，轻松达到职业级打字速度与准确性）
- 如何正确组装机箱装显卡——让你的电脑性能飞跃（从零开始，轻松掌握组装机箱装显卡的技巧与方法）
- 乐酷1手机的全面评测（功能强大，性价比超高）
- 海尔UHome（探索智能家居解决方案，让生活更便捷）
- 以k快启动安装教程（轻松安装k快启动，提升系统启动速度）
- 用大白菜U盘装系统PE教程（使用大白菜U盘制作PE系统，让您轻松安装操作系统）
- 小米电脑笔记本使用教程（轻松上手小米电脑笔记本，让你的工作生活更高效）
- 苹果小白重装系统教程（轻松学会苹果设备的系统重装技巧）
- 如何更换声卡驱动？（详细教程和注意事项）
- 电脑扫描文件的技巧与方法（学会电脑扫描文件，提高工作效率）
随便看看
- Copyright © 2025 Powered by Maven Archetype 多 Module 自定义代码脚手架,创站工坊 滇ICP备2023006006号-44sitemap