Gradle使用JUnit 5的官方文档缺失BOM依赖，是bug还是有意为之？

这不是文档bug，是Gradle官方有意为之的写法，核心原因有两点：

• 示例优先保证简洁性：Gradle文档里的示例是面向入门用户的基础用法，直接指定具体版本号能让新手快速完成依赖引入，无需先理解BOM（物料清单）的进阶概念——BOM主要用于统一多组件版本，对入门场景来说属于额外学习成本。
• 适配不同使用场景：如果项目只需要引入junit-jupiter这单一JUnit 5依赖，直接写版本号的写法足够轻便；而JUnit官方推荐的BOM写法，更适合需要引入多个JUnit 5组件（比如JUnit Jupiter、JUnit Vintage、JUnit Platform等）的场景，能自动统一所有组件版本，避免版本冲突。

两种写法都是合法的：

• JUnit官方推荐的BOM方式：

  dependencies {
      testImplementation(platform('org.junit:junit-bom:5.9.1'))
      testImplementation('org.junit.jupiter:junit-jupiter')
  }
  

• Gradle文档的基础写法：

  dependencies {
      testImplementation 'org.junit.jupiter:junit-jupiter:5.7.1'
  }
  

如果是大型项目或需要引入多个JUnit组件，更推荐用BOM方式管理版本；如果只是简单单元测试场景，Gradle文档的写法完全够用。

内容的提问来源于stack exchange，提问作者becke-ch