本文介绍如何通过 Maven 的 maven-antrun-plugin 插件，在构建生命周期中动态创建目标目录，并精准复制编译产物（如 JAR 文件）、资源脚本及其他项目文件到类生产环境的多级路径中，满足非打包（如不生成 ZIP）但需预部署结构的自动化需求。
本文介绍如何通过 maven 的 `maven-antrun-plugin` 插件，在构建生命周期中动态创建目标目录，并精准复制编译产物（如 jar 文件）、资源脚本及其他项目文件到类生产环境的多级路径中，满足非打包（如不生成 zip）但需预部署结构的自动化需求。
在从 Ant 迁移至 Maven 的过程中，仅依靠 mvn compile 或 mvn package 无法直接复现 Ant 中灵活的文件组织与分发逻辑——尤其是当需要将不同来源的文件（如 target/*.jar、src/main/scripts/、srs/foo/bar/scripts/）按定制路径结构（例如 /usr/local/myFoo/spam/bar/scripts 或 /usr/local/tomcat/webapps/fooApp/WEB-INF/lib）分别写入时。Maven 原生插件（如 maven-install-plugin 或 maven-dependency-plugin）侧重于构件安装或依赖解析，不支持任意路径的多源文件树复制与目录自动创建。
此时，maven-antrun-plugin 是最轻量且可靠的解决方案：它内嵌 Apache Ant 引擎，可直接调用
以下是一个生产就绪的完整配置示例，完成三项核心任务：
✅ 自动创建多级目标目录（如 /usr/local/myFoo/spam/bar/scripts）
✅ 复制项目内脚本资源到对应路径
✅ 将构建输出的 JAR 及依赖库同步至 Tomcat 的 WEB-INF/lib
<plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-antrun-plugin</artifactid><version>3.1.0</version><!-- 推荐使用最新稳定版 --><executions><!-- 步骤1：创建目录结构并复制脚本 --><execution><id>setup-scripts</id><phase>prepare-package</phase><!-- 在 package 前执行，确保目录就绪 --><goals><goal>run</goal></goals><configuration><target><!-- 创建目标脚本目录（自动递归创建父目录） --><mkdir dir="/usr/local/myFoo/spam/bar/scripts"></mkdir><!-- 复制本地脚本资源 --><copy todir="/usr/local/myFoo/spam/bar/scripts" overwrite="true"><fileset dir="srs/foo/bar/scripts"><include name="**/*.sh"></include><include name="**/*.py"></include></fileset></copy></target></configuration></execution><!-- 步骤2：复制 JAR 与依赖到 WEB-INF/lib --><execution><id>copy-to-webapp-lib</id><phase>package</phase><goals><goal>run</goal></goals><configuration><target><mkdir dir="/usr/local/tomcat/webapps/fooApp/WEB-INF/lib"></mkdir><!-- 复制主模块 JAR --><copy file="${project.build.directory}/${project.build.finalName}.jar" tofile="/usr/local/tomcat/webapps/fooApp/WEB-INF/lib/${project.build.finalName}.jar" overwrite="true"></copy><!-- 复制所有 runtime 依赖（需配合 maven-dependency-plugin 预先解压到 target/lib） --><copy todir="/usr/local/tomcat/webapps/fooApp/WEB-INF/lib" overwrite="true"><fileset dir="${project.build.directory}/lib"><include name="*.jar"></include></fileset></copy></target></configuration></execution></executions></plugin>
⚠️ 关键注意事项：
-
权限与路径安全：上述绝对路径（如 /usr/local/...）在 CI/CD 环境中可能因权限受限失败。建议通过 Maven 属性参数化路径（如
${env.INSTALL_DIR:-/tmp/deploy} ），并在运行时注入；本地开发可设为相对路径（如 target/deploy）以保障可移植性。 - 依赖预提取：若需复制第三方依赖 JAR，需先在 package 阶段前用 maven-dependency-plugin 解压依赖至 target/lib，否则 fileset 将无源可读。
- 执行时机选择：prepare-package 阶段适合前置准备，package 或 install 阶段适合最终产物分发；避免使用 deploy 阶段，因其默认绑定远程仓库上传，与本地文件操作语义冲突。
-
跨平台兼容性：Ant 的
和 均支持跨平台路径处理，但路径分隔符建议统一使用正斜杠 /（Ant 会自动转换），避免硬编码 \。
综上，maven-antrun-plugin 并非“临时补丁”，而是 Maven 生态中处理定制化文件系统操作的标准实践。它平衡了声明式配置与过程式灵活性，是 Ant 迁移场景下最平滑、可维护性最强的技术选型。
