本文介绍如何通过 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 引擎，可直接调用 <mkdir>、<copy>、<sync> 等原生命令，完全兼容复杂路径映射与条件逻辑，且支持 ${project.build.directory}、${maven.build.timestamp} 等 Maven 属性，实现声明式配置。
以下是一个生产就绪的完整配置示例，完成三项核心任务：
✅ 自动创建多级目标目录（如 /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"/>
<!-- 复制本地脚本资源 -->
<copy todir="/usr/local/myFoo/spam/bar/scripts" overwrite="true">
<fileset dir="srs/foo/bar/scripts">
<include name="**/*.sh"/>
<include name="**/*.py"/>
</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"/>
<!-- 复制主模块 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"/>
<!-- 复制所有 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"/>
</fileset>
</copy>
</target>
</configuration>
</execution>
</executions>
</plugin>⚠️ 关键注意事项：
- 权限与路径安全：上述绝对路径（如 /usr/local/...）在 CI/CD 环境中可能因权限受限失败。建议通过 Maven 属性参数化路径（如 <install.dir>${env.INSTALL_DIR:-/tmp/deploy}</install.dir>），并在运行时注入；本地开发可设为相对路径（如 target/deploy）以保障可移植性。
- 依赖预提取：若需复制第三方依赖 JAR，需先在 package 阶段前用 maven-dependency-plugin 解压依赖至 target/lib，否则 fileset 将无源可读。
- 执行时机选择：prepare-package 阶段适合前置准备，package 或 install 阶段适合最终产物分发；避免使用 deploy 阶段，因其默认绑定远程仓库上传，与本地文件操作语义冲突。
- 跨平台兼容性：Ant 的 <mkdir> 和 <copy> 均支持跨平台路径处理，但路径分隔符建议统一使用正斜杠 /（Ant 会自动转换），避免硬编码 \。
综上，maven-antrun-plugin 并非“临时补丁”，而是 Maven 生态中处理定制化文件系统操作的标准实践。它平衡了声明式配置与过程式灵活性，是 Ant 迁移场景下最平滑、可维护性最强的技术选型。
