Maven 的依赖管理是项目构建的核心通过 pom.xml 中的dependencies元素声明项目所需的第三方库。以下是对依赖使用的系统性总结涵盖常见场景和最佳实践。1. 基本依赖声明dependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactIdversion2.7.0/versionscopecompile/scope!-- 默认 compile --optionalfalse/optional!-- 默认 false --exclusionsexclusiongroupId.../groupIdartifactId.../artifactId/exclusion/exclusions/dependency/dependencies必填项groupId、artifactId、version除非继承父POM或由 dependencyManagement 管理version可以不填。2. 依赖范围ScopeScope编译器测试期运行期打包包含典型场景compile✔✔✔✔核心库provided✔✔✘✘lombok等runtime✘✔✔✔jdbc驱动test✘✔✘✘JUnit、Mockitosystem✔✔✘✘本地JAR需配合不推荐import----仅用于 dependencyManagement导入BOMimport 的关键约束dependencyManagementdependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-dependencies/artifactIdversion2.7.0/versiontypepom/type!-- 必须指定 typepom --scopeimport/scope!-- 必须指定 scopeimport --/dependency/dependencies/dependencyManagement只能用在dependencyManagement中不能出现在普通的dependencies里。必须指定 pom因为导入的目标是一个 POM 文件而不是 jar。必须指定 import告诉 Maven 这是导入依赖管理而不是实际引入依赖。被导入的 POM 必须本身包含 节否则导入无效。3. 排除依赖项ExclusionsdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-web/artifactIdversion2.7.0/versionscopecompile/scope!-- 默认 compile --optionalfalse/optional!-- 默认 false --exclusionsexclusiongroupId.../groupIdartifactId.../artifactId/exclusion/exclusions/dependency典型场景排除旧版commons-logging、 Log4j、SLF4J 桥接冲突gson等。4. 依赖不传递Optional 它的核心作用是控制依赖的传递性当一个依赖被声明为 optionaltrue 时该依赖不会自动传递给依赖当前项目的下游项目。dependencygroupIdcom.example/groupIdartifactIdsome-lib/artifactIdversion1.0/versionoptionaltrue/optional!-- 默认 false --/dependencyoptional 默认为 false表示该依赖是必需的并且会向下游传递。设置为 true 后该依赖不会被下游项目继承但当前项目本身仍然可以使用它编译、测试、运行都需要它。5. 引用本地jarsystemdependencygroupIdcom.legacy/groupIdartifactIdold-lib/artifactIdversion1.0/versionscopesystem/scopesystemPath${project.basedir}/lib/old-lib.jar/systemPath/dependency强烈不建议使用本地依赖推荐上传到maven私服主要有下述几个原因该 jar 不会被打入 WAR/JAR 包除非额外配置 maven-war-plugin无法被传递依赖引用跨机器构建时路径可能不一致无法被依赖分析工具识别6. 依赖检查两个常用命令mvn dependency:tree# 查看完整依赖树mvn dependency:analyze# 分析未使用/未声明的依赖定期清理无用依赖运行 mvn dependency:analyze 找出 Unused declared dependencies 和 Used undeclared dependencies。