如何在 IDEA 中添加 Maven 项目的 Archetype（解决添加不起作用的问题）

自定义Maven archetype：添加和使用自定义脚手架教程

最新推荐文章于 2025-03-02 17:25:01 发布

原创最新推荐文章于 2025-03-02 17:25:01 发布 · 1.9w 阅读

CC 4.0 BY-SA版权

文章标签：

本文详细介绍了如何在IntelliJ IDEA中创建和添加自定义Maven archetype，包括从现有项目生成、本地仓库安装、配置UserArchetypes.xml，以及确保脚手架在新建模块时可见的过程。

前言

在 IDEA 中点击新建 Maven 模块，会发现他已经为我们罗列出来了许多的 archetype，但有些时候满足不了我们

打开终端，cd 到这个模块的根目录，比如这里是 D:/Java_Study/idea_projects/springmvc-course/ssm-quickstart，然后运行 mvn archetype:create-from-project，等待构建完成。
接着 cd 到生成的 target/generated-sources/archetype 目录，运行 mvn install，这时候会将项目打包到本地仓库。

在 IDEA 中新建一个模块，选择 Maven --> Create form archetype --> Add archetype，之后在弹出的对话框中填入坐标和版本号，需要注意的是工件 ID 的最后应该有 -archetype 后缀。

的需求。下面就来看看如何添加自己的脚手架吧。

当你自信满满地完成以上步骤之后，可能会碰到一个问题：怎么回事小老弟，列表中怎么没有出现刚刚添加的脚手架嘞？遇事不决，重启一波，发现还是没用

解决方案：

这时候需要去 C:/Users/[你的用户名]/AppData/Local/JetBrains/IntelliJIdea2021.2/Maven/Indices 目录下，创建一个 UserArchetypes.xml 文件，内容参考如下：

<archetypes>
    <archetype groupId="com.zhiyiyo" artifactId="ssm-quickstart-archetype" version="1.0" />
</archetypes>

重启一波 IDEA，新建模块，这时候就会发现原型列表中出现了我们自定义的脚手架：