Maven依赖Scope选项详解

关注

转载最新推荐文章于 2026-09-27 13:59:29 发布 542 阅读 AI 写同款· GEO 优化 ›

【Maven】-- Maven Scope 详解 Scope编译（Compile）测试（Test）运行（Runtime）典型使用场景compile（默认）✅✅✅普通依赖，如 Apache Commonsprovided✅✅❌运行环境提供的库，如runtime❌✅✅运行时才需要的库，如test❌✅❌测试框架，如 JUnitsystem✅✅✅本地 jar，如商业库（不推荐）import❌❌❌仅用于。阅读详情

转载自https://www.jianshu.com/p/fb09a49d4d1b
转载这篇文章主要是这篇是简书中的无法被收藏，且在初学Maven时有所疑问，故记录一下。

在一个maven项目中，如果存在编译需要而发布不需要的jar包，可以用scope标签，值设为provided。

如下：

<dependency>
  <groupId>javax.servlet.jsp</groupId>
  <artifactId>jsp-api</artifactId>
  <version>2.3</version>
  <scope>provided</scope>      
</dependency>

Scope的其他参数如下：

scope	说明	实例
compile	编译时需要用到该jar包（默认）	commons-logging
test	编译Test时需要用到该jar包	junit
runtime	编译时不需要，但运行时需要用到	mysql
provided	编译时需要用到，但运行时由JDK或某个服务器提供	servlet-api

compile：默认的scope，表示 dependency 都可以在生命周期中使用。
而且，这些dependencies 会传递到依赖的项目中。适用于所有阶段，会随着项目一起发布
provided：跟compile相似，但是表明了dependency 由JDK或者容器提供，例如Servlet AP和一些Java EE APIs。这个scope 只能作用在编译和测试时，同时没有传递性，即：child module无法引用。
runtime：表示dependency不作用在编译时，但会作用在运行和测试时，如JDBC驱动，适用运行和测试阶段，与provided相反。
test：表示dependency作用在测试时，不作用在运行时。只在测试时使用，用于编译和运行测试代码。不会随项目发布。
system：跟provided 相似，但是在系统中要以外部JAR包的形式提供，maven不会在repository查找它。