Maven构建时看似“跳过”依赖下载，实则是将所有依赖统一缓存至本地仓库（~/.m2/repository），而非复制到项目target目录；target中只包含编译产物（如jar），依赖由类加载器在运行/测试阶段按需解析，这是Maven“一次下载、多项目共享”的核心设计。
maven构建成功却未下载依赖到target目录？真相与最佳实践解析
你刚执行 mvn package 成功生成了 target/fourier-transform-library-*.jar，却发现 target/ 下没有 junit.jar——这并非异常，而是 Maven 精心设计的依赖管理机制在正常工作。
✅ 为什么 build 成功，却不见 junit.jar 在 target 中？
Maven 从不把依赖 JAR 复制进 target/ 目录（除非你显式配置了 maven-dependency-plugin 的 copy-dependencies 目标）。target/ 是构建输出目录，仅存放：
- 编译后的
.class文件（target/classes/） - 测试编译文件（
target/test-classes/） - 最终打包产物（如
target/fourier-transform-library-1.0.0.jar）
而 junit 等依赖，被 Maven 下载并永久存储在本地仓库中：
~/.m2/repository/junit/junit/4.13.2/junit-4.13.2.jar # 示例路径（Linux/macOS） %USERPROFILE%\.m2\repository\junit\junit\4.13.2\junit-4.13.2.jar # Windows
该路径是 Maven 的本地仓库（Local Repository），所有项目共享此目录。首次构建时，Maven 自动检查本地仓库是否存在所需依赖（通过 groupId:artifactId:version 坐标）；若缺失，则从远程仓库（如中央仓库或阿里云镜像）下载并缓存至此，后续构建直接复用——无需重复下载，也无需污染项目目录。
? 验证方法：运行
mvn dependency:tree -Dincludes=junit，可清晰看到 junit 已被解析并参与编译/测试生命周期，但不会出现在target/中。
✅ 构建流程中的依赖角色分层明确
| 阶段 | 依赖是否参与？ | 说明 |
|---|---|---|
mvn compile |
❌ 否（默认） |
junit 的 scope 默认为 test，仅用于 src/test/java，不影响主代码编译 |
mvn test |
✅ 是 | Maven 启动测试时，自动将 ~/.m2/repository 中的 junit.jar 加入 classpath |
mvn package |
❌ 否（对最终 jar） | 主模块 JAR 默认不含依赖（即 thin jar）；junit 不被打包进你的库中，符合语义隔离原则 |
✅ 正因如此，你的 FFT 库才能干净地被其他项目引用——使用者只需声明 <dependency><groupid>tambapps</groupid><artifactid>fourier-transform-library</artifactid>...</dependency>，Maven 会自动拉取它本身 + 其传递依赖（如有），而 junit 因 scope="test" 不会向上传递。
⚠️ 注意事项与常见误区
-
不要手动向
target/放置 JAR：这违背 Maven 约定，会导致构建不可重现、CI 失败、IDE 同步异常。 -
mvn clean安全无忧：它只删除target/，绝不触碰~/.m2/repository——你的所有依赖毫发无损，下次构建秒级恢复。 -
依赖冲突？看
mvn dependency:tree -Dverbose：当多个版本共存时，Maven 按“最近优先”策略选择，但可通过<exclusions></exclusions>或<dependencymanagement></dependencymanagement>精准控制。 -
想生成含依赖的 fat jar？ 使用
spring-boot-maven-plugin（Spring Boot 项目）或maven-assembly-plugin显式配置：<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-assembly-plugin</artifactId> <configuration> <descriptorRefs><descriptorRef>jar-with-dependencies</descriptorRef></descriptorRefs> </configuration> <executions> <execution> <phase>package</phase> <goals><goal>single</goal></goals> </execution> </executions> </plugin>
✅ 总结：理解 Maven 的“仓库思维”，告别路径焦虑
Maven 的本质不是“把所有东西塞进项目文件夹”，而是建立一套分层、共享、可追溯的构件管理体系：
-
本地仓库（
~/.m2/repository） → 你的私有依赖 CDN（所有项目共用，持久化） -
远程仓库（如
https://maven.aliyun.com/repository/public） → 高速公共源（推荐在settings.xml中配置镜像） -
项目
pom.xml→ 声明“我需要什么”，而非“我把东西放哪”
当你下次看到 BUILD SUCCESS 却没在 target/ 找到依赖时，请放心：Maven 已默默完成最高效的工作——下载一次，复用百次，构建纯粹，协作无忧。
