使用命令行下载Maven依赖是Java开发中常见的需求,尤其在自动化构建、离线开发等场景下非常实用，Maven通过命令行可以灵活地下载单个依赖、整个项目的依赖，或指定下载位置和范围，以下是具体操作方法和注意事项。
环境准备
在使用命令行下载依赖前,需确保已安装Java环境（JDK 8及以上）并配置好Maven环境变量，可通过以下命令验证安装是否成功：
mvn -version
若显示Maven版本和Java路径,则表示环境配置正确，默认情况下，Maven依赖会下载到本地仓库（路径为~/.m2/repository，Windows下为C:Users用户名.m2repository）。
核心命令详解
下载单个依赖
使用mvn dependency:get命令可下载指定的依赖，需通过-Dartifact参数指定依赖坐标（格式：groupId:artifactId:version:packaging，packaging默认为jar，可省略）。
示例：下载Spring Core依赖（版本5.3.23）
mvn dependency:get -Dartifact=org.springframework:spring-core:5.3.23
执行后,依赖会自动下载到本地仓库，并显示下载路径。
下载项目所有依赖
若需下载当前项目的所有依赖（包括传递依赖），可在项目根目录执行mvn dependency:copy-dependencies命令，默认会将依赖复制到target/dependency目录。
常用参数：
-DoutputDirectory：指定自定义输出目录（如-DoutputDirectory=lib）-DincludeScope：指定依赖作用域（如compile、test，默认包含所有作用域）
示例：将项目所有编译依赖下载到lib目录mvn dependency:copy-dependencies -DoutputDirectory=lib -DincludeScope=compile
解析并下载依赖（不构建项目）
若仅需下载依赖而不执行编译、测试等步骤，可使用mvn dependency:resolve命令，该命令会解析依赖树并下载所有未下载的依赖到本地仓库。
mvn dependency:resolve
常用参数与场景举例
| 场景需求 | 命令示例 | 说明 |
|---|---|---|
| 下载指定分类器的依赖 | mvn dependency:get -Dartifact=com.alibaba:fastjson:1.2.83:javadoc |
下载fastjson的Javadoc文档（分类器为javadoc） |
| 下载到自定义本地仓库 | mvn dependency:get -Dartifact=org.apache.commons:commons-lang3:3.12.6 -Dmaven.repo.local=/custom/repo |
指定本地仓库路径（需绝对路径） |
| 跳过校验下载 | mvn dependency:get -Dartifact=org.slf4j:slf4j-api:1.7.36 -Dtransitive=false |
跳过传递依赖，仅下载指定依赖 |
| 显示下载进度 | mvn dependency:get -Dartifact=... -Dverbose=true |
启用详细日志，显示下载进度和依赖信息 |
常见问题处理
- 下载失败（Could not transfer artifact）：通常为网络问题，可尝试更换Maven镜像源（在
settings.xml中配置阿里云镜像：<mirror><id>aliyun</id><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf></mirror>）。 - 依赖冲突：通过
mvn dependency:tree命令查看依赖树，定位冲突依赖后使用<exclusions>排除或手动指定版本。
相关问答FAQs
Q1: 命令行下载Maven依赖时出现“Could not transfer artifact”错误怎么办？
A: 该错误多为网络连接或镜像源问题，首先检查网络是否正常，然后配置国内镜像源（如阿里云、华为云），在Maven的settings.xml文件中的<mirrors>节点添加如下配置：
<mirror>
<id>aliyun</id>
<name>aliyun maven</name>
<url>https://maven.aliyun.com/repository/public</url>
<mirrorOf>central</mirrorOf>
</mirror>
保存后重新执行下载命令即可。
Q2: 如何通过命令行下载依赖的源码（Source）和Javadoc文档？
A: 可在dependency:get命令中指定分类器（Classifier）为sources或javadoc，示例：
# 下载源码 mvn dependency:get -Dartifact=org.apache.commons:commons-lang3:3.12.6:sources # 下载Javadoc mvn dependency:get -Dartifact=org.apache.commons:commons-lang3:3.12.6:javadoc
下载后,源码和文档会存放在本地仓库对应依赖目录下的sources和javadoc文件夹中。
原创文章，发布者：酷番叔，转转请注明出处：https://cloud.kd.cn/ask/16890.html
