maven archetype 插件通过 mvn archetype:generate 命令一键生成项目骨架,支持官方模板、本地企业模板和远程私服模板三种方式,需指定坐标、参数并设 -dinteractivemode=false 避免卡顿。

用 Maven Archetype 插件一键生成项目,本质是调用 mvn archetype:generate 命令并传入模板坐标与参数,跳过手动建目录、写 pom.xml、补包结构等重复劳动,5秒内输出完整可编译的项目骨架。
从官方模板快速生成标准 Java 项目
这一步适合刚入门或只需基础结构的场景,不依赖任何自定义模板。
在终端中执行命令:mvn archetype:generate -DarchetypeArtifactId=maven-archetype-quickstart -DgroupId=com.example -DartifactId=demo-app -Dversion=1.0-SNAPSHOT -Dpackage=com.example.demo -DinteractiveMode=false
【必须加 -DinteractiveMode=false】 否则 Maven 会卡在交互式菜单等待你手动选编号,看似“一键”实则卡住。
执行后会在当前目录下生成 demo-app/ 文件夹,含标准 src/main/java、src/test/java 和带 JUnit 示例的 pom.xml。
使用本地已安装的企业级模板
当团队已将 Ruoyi-Activiti 或 Spring Boot 规范打包为 archetype 并执行过 mvn install,就能直接调用。
第一步:确认模板已注册到本地仓库
打开 ~/.m2/repository/archetype-catalog.xml,查找类似 <archetype><groupid>cn.felord</groupid><artifactid>ruoyi-activiti-archetype</artifactid><version>2.3.0</version></archetype> 的条目。
第二步:运行生成命令mvn archetype:generate -DarchetypeGroupId=cn.felord -DarchetypeArtifactId=ruoyi-activiti-archetype -DarchetypeVersion=2.3.0 -DgroupId=com.myorg -DartifactId=hr-process -DcompanyName=myorg -DinteractiveMode=false
注意:若模板中定义了 <requiredproperty key="companyName"></requiredproperty>,此处必须传值,否则生成中断且无提示。
从远程私服拉取并生成项目
适用于企业统一托管模板、禁止本地 install 的安全管控环境。
方法一:指定远程 catalog 地址mvn archetype:generate -DarchetypeCatalog=https://nexus.myorg.com/repository/maven-public/archetype-catalog.xml -DarchetypeGroupId=com.myorg -DarchetypeArtifactId=boot3-archetype -DarchetypeVersion=1.8.2 -DgroupId=com.myorg.biz -DartifactId=order-service
方法二:先更新本地 catalog 再生成
执行 mvn archetype:update-local-catalog -Dcatalog=https://nexus.myorg.com/repository/maven-public/archetype-catalog.xml → 然后运行普通 mvn archetype:generate 命令即可自动匹配远程模板。
这一步操作起来很简单,直接把文件拖进去就行。











