大部分公司都会有一个通用的模板项目，帮助你快速创建一个项目。通常，这个项目需要集成一些公司内部的

、标准的代码格式、通用的代码分层等等。

今天，就利用 Maven 的 Archetype 插件来简单实现这一功能。

很清楚可以看到，实际利用这个插件机制就简单的几个步骤：

archetype:create-from-project ，根据自己的项目代码生成原型项目

通过 install 等命令生成原型文件

archetype:generate，通过原型生成目标项目

看起来挺简单的，但是你会发现你用网上搜到的资料来玩的话，你生成的项目特别傻X，包括官方的文档

一堆问题，比如 module 名称不会变、包名变了代码中没变，依赖报错一大堆问题，还是有必要说下中间要怎么做的。

首先，准备好我们自己的模板项目，保证代码都是OK的。

文件夹，这个很简单，不会有任何障碍，你看下面的图，注意看每个模块的名字，这是我改过的！！

你生成应该会发现他不长这样，这就是问题啊！接着往下看吧。

这里最核心的部分就在于怎么修改

target/generated-sources/src/main/resources/archetype-resources

如果不修改直接继续的话，最终生成的项目会发现module的名称不会变，包名也不会变，代码里引用的会有一堆报错。

接着，我们看看咋改的，这一堆破问题。

文件，会发现缺少module信息，这个必须加上。

    <modules>
        <module>${rootArtifactId}-admin</module>
        <module>${rootArtifactId}-common</module>
        <module>${rootArtifactId}-extend</module>
        <module>${rootArtifactId}-framework</module>
        <module>${rootArtifactId}-generator</module>
        <module>${rootArtifactId}-quartz</module>
        <module>${rootArtifactId}-system</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中的互相引用 groupId 和 artifactId 按照父 pom 的方式对应修改。

文件，修改modules相关的部分，重点注意看 id 、dir、name 的修改方式。

经过上面的步骤，原型 Archetype 已经创建完成，其实最大的坑也就是上面那部分，花了老半天时间，简直坑爹啊。

下面看看怎么使用吧，两种使用方式。

随便进入你想保存项目的路径，执行命令。

mvn archetype:generate -DarchetypeCatalog=local


依次按照提示输入 groupId、artifactId 即可完成创建。

你的本地maven仓库目录（比如~/.m2/repository）有一个文件

<?xml version="1.0" encoding="UTF-8"?>
<archetype-catalog xsi:schemaLocation="http://maven.apache.org/plugins/maven-archetype-plugin/archetype-catalog/1.0.0 https://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.ruoyi</groupId>
      <artifactId>ruoyi-archetype</artifactId>
      <version>3.9.2</version>
      <description>管理系统</description>
    </archetype>
  </archetypes>
</archetype-catalog>

新建项目，选择 Maven，勾选 Create from archetype，选择 Add Archetype...

接着，输入我们自定义的 Archetype 的 GroupId、ArtifactId、Version 信息。

Add 成功之后就可以在列表中看到我们自己的 archetype，然后按照流程创建即可。

大部分公司都会有一个通用的模板项目，帮助你快速创建一个项目。通常，这个项目需要集成一些公司内部的中间件、单元测试、标准的代码格式、通用的代码分层等等。

Maven Archetype 多 Module 自定义代码脚手架

java的多模块的脚手架的构建：大部分公司都会有一个通用的模板项目，帮助你快速创建一个项目。通常，这个项目需要集成一些公司内部的中间件、单元测试、标准的代码格式、通用的代码分层等等。

开发工具

本文详解Maven Archetype插件自定义项目模板，解决生成项目module名称不变、包名未更新及依赖报错等常见问题。核心步骤包括：执行archetype:create-from-project生成原型，修改父pom、module及archetype-metadata.xml配置，最后通过mvn install或deploy发布。提供命令行与IDEA两种使用方式，并分享archetype-catalog.xml共享技巧，助力团队快速搭建统一标准项目结构。

单元测试

代码解释

中间件

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

本文详解Maven Archetype插件自定义项目模板，解决生成项目module名称不变、包名未更新及依赖报错等常见问题。核心步骤包括：执行archetype:create-from-project生成原型，修改父pom、module及archetype-metadata.xml配置，最后通过mvn install或...

Maven Archetype 多 Module 自定义代码脚手架

Maven Archetype 多 Module 自定义代码脚手架

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐