2.3 依赖管理Maven工具-＞dependency详解：JUnit 3.8.1 vs 4.12

复制代码

<dependency> 
	<groupId>junit</groupId> 
	<artifactId>junit</artifactId> 
	<version>3.8.1</version>
	<scope>test</scope> 
</dependency> 
<dependency> 
	<groupId>junit</groupId> 
	<artifactId>junit</artifactId> 
	<version>4.12</version> 
	<scope>compile</scope> 
</dependency>

两段依赖配置的核心区别解析

这两段配置都是引入 JUnit 依赖，但在版本号 、作用域（scope） 上有本质区别，最终导致 JUnit 在项目中的生效范围、使用方式完全不同

1. 核心区别对照表

维度	第一段配置（JUnit 3.8.1）	第二段配置（JUnit 4.12）
版本号	3.8.1（JUnit 3 系列，老旧版本）	4.12（JUnit 4 系列，经典稳定版本）
核心语法	基于继承 + 命名约定（如测试类继承 TestCase，方法名以 test 开头）	基于注解（如 `@Test`、`@Before`）
scope 作用域	`test`（仅测试代码生效，主代码不可见）	`compile`（主代码 + 测试代码均生效）
打包行为	不会被打入最终 jar/war 包	会被打入最终包（可能导致包冗余）
依赖传递性	仅测试阶段传递给子模块	编译阶段传递给子模块

关键概念详解

scope：依赖作用域（核心区别）

scope 是 Maven 控制依赖生效阶段 和可见范围的核心属性：

test 作用域：

仅对 src/test/java 目录下的测试代码生效，src/main/java 中的主业务代码无法引用 JUnit 3.8.1 的类（比如 TestCase）

打包（mvn package）时，该依赖不会被包含到最终的 jar/war 包中（测试代码本身也不会打包），符合 "测试依赖不污染生产包" 的最佳实践
compile 作用域（默认值，不写则默认 compile）：

对主代码（src/main/java）和测试代码（src/test/java）都生效

打包时会被打入最终包，但 JUnit 是测试工具，主代码根本不需要依赖它 ，这种配置是不规范的错误写法（会导致生产包冗余，甚至可能引发依赖冲突）

JUnit 版本差异

JUnit 3.8.1：2004 年的老旧版本，无注解支持，测试逻辑必须遵循严格的命名和继承规则，灵活性差
JUnit 4.12：2014 年发布的稳定版本，引入注解体系，彻底摆脱继承约束，是目前仍广泛使用的版本（JUnit 5 是主流，但 4 仍兼容大量老项目）

实际使用效果示例

假设项目目录结构：

复制代码

src/
├── main/java/com/xxx/  # 主业务代码
└── test/java/com/xxx/  # 测试代码

第一段配置（JUnit 3.8.1 + test）：

只能在 src/test/java 中写 JUnit 3 风格的测试代码，比如：
复制代码
```
// 仅测试代码中可用
public class UserTest extends TestCase {
    public void testAddUser() { // 方法名必须以 test 开头
        // 测试逻辑
    }
}
```
主代码 src/main/java 中写 import junit.framework.TestCase; 会提示 "找不到类"（依赖不可见）
第二段配置（JUnit 4.12 + compile）：

主代码中也能写 import org.junit.Test;，但这毫无意义（主代码不需要测试注解）

打包后，最终的 jar 包中会包含 junit-4.12.jar，增加包体积，且生产环境根本用不到

正确的配置写法

JUnit 作为测试依赖，无论哪个版本，scope 都必须设为 test，且建议统一使用 JUnit 4（避免 3/4 版本冲突），正确配置如下：

复制代码

<!-- 推荐：JUnit 4.12 + test 作用域（符合最佳实践） -->
<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
    <scope>test</scope> <!-- 仅测试代码生效，不打包 -->
</dependency>

总结

核心区别 ：scope 是关键 ------test 仅测试代码生效且不打包，compile 主 / 测代码均生效且打包（JUnit 用 compile 是错误的）；版本上 3.8.1 是老旧的 "命名约定式" 测试，4.12 是 "注解式" 测试
规范写法 ：JUnit 依赖必须设置 scope=test，优先使用 4.x 版本（如 4.12），避免主代码依赖测试库、包冗余
避坑提醒：同一项目同时引入 JUnit 3 和 4 会导致依赖冲突，实际开发中应只保留一个版本（推荐 4.12 + test）