本文介绍如何使用 maven 内置插件一键下载当前项目所有已声明的依赖（含传递依赖），并将其复制到自定义本地目录，从而快速构建可离线使用的依赖集，无需手动下载或依赖中央仓库同步。
本文介绍如何使用 maven 内置插件一键下载当前项目所有已声明的依赖（含传递依赖），并将其复制到自定义本地目录，从而快速构建可离线使用的依赖集，无需手动下载或依赖中央仓库同步。
在实际开发中，有时需要将 Maven 项目的全部依赖（包括直接依赖和传递依赖）打包导出，用于离线环境部署、CI/CD 缓存预热、或补充本地 .m2/repository 中缺失的构件。此时，并不推荐从第三方网站下载“完整仓库镜像”——既不可信，也不精准（版本、范围、classifier 等难以匹配）；更高效、安全且可复现的方式是基于当前 pom.xml 声明，由 Maven 自动解析并拉取所需 artifact。
Maven 官方提供的 maven-dependency-plugin 提供了开箱即用的能力。其中 dependency:copy-dependencies 目标专为此类场景设计：它会读取项目依赖树，按 scope（默认仅 compile 和 runtime）、是否排除测试依赖等规则筛选，然后将对应 JAR（及 POM、sources、javadoc 等，可选）统一复制到指定输出目录。
✅ 使用方法如下：
- 确保当前目录下存在有效的 pom.xml（即该 Maven 项目已正确配置所有所需依赖）；
- 执行以下命令（请将 OUTPUT_DIR 替换为你的目标路径，如 ./libs）：
mvn dependency:copy-dependencies -DoutputDirectory=./libs
? 补充常用参数（增强实用性）：
- -DincludeScope=runtime：仅复制 runtime 及以上 scope 的依赖（适合运行时分发）；
- -DexcludeTransitive=true：排除传递依赖（仅保留直接声明的依赖）；
- -Dclassifier=sources：同时下载源码包（需对应 artifact 支持）；
- -DstripVersion=true：移除文件名中的版本号（如 spring-core-6.1.0.jar → spring-core.jar），便于脚本处理；
- -DfailOnMissingClassifierArtifact=false：当某依赖无 sources/javadoc 时跳过而非报错。
⚠️ 注意事项：
- 该命令不会修改本地 .m2/repository，仅执行“复制”操作，因此不会污染你的全局仓库；
- 首次执行时，Maven 仍需联网下载缺失 artifact 到 .m2，再复制到目标目录；后续重复执行将直接从本地仓库读取；
- 若需导出整个多模块项目的全部依赖，建议在根 pom.xml 所在目录执行，并确保
pom 下各子模块依赖关系已正确定义； - 如需生成带依赖树结构的 ZIP 包，可结合 maven-assembly-plugin 或 maven-shade-plugin 进阶使用。
总结：与其寻找“预编译的通用仓库包”，不如信任 Maven 的依赖解析机制——以 pom.xml 为唯一事实源，用 dependency:copy-dependencies 精准、可重复、可审计地导出所需依赖集合。这是 DevOps 实践与离线交付中的标准推荐方案。
