Gradle 中如何在构建时动态获取并强制使用特定传递依赖的版本
详解如何在 build.gradle 中不显式声明、而通过排除策略与解析机制，精准捕获并锁定某依赖项所引入的特定传递依赖版本 今天我们来探讨一个在 Gradle 依赖管理中颇具技巧性的场景：如何在不直接声明的情况下，精准锁定某个传递依赖的特定版本。比如，你明确需要 `group:module:2.0
详解如何在 build.gradle 中不显式声明、而通过排除策略与解析机制，精准捕获并锁定某依赖项所引入的特定传递依赖版本
今天我们来探讨一个在 Gradle 依赖管理中颇具技巧性的场景：如何在不直接声明的情况下，精准锁定某个传递依赖的特定版本。比如，你明确需要 `group:module:2.0.0` 这个版本，但它是由上游依赖 `my-dependency-1` 间接引入的，而另一个依赖 `my-dependency-2` 却带来了冲突的 `3.0.0` 版本。我们的目标，就是通过构建时的动态约束，让 `2.0.0` 胜出。
在 Gradle 的世界里，“传递依赖”是把双刃剑。它自动帮你拉取依赖链上的所有子依赖，省时省力；可一旦多个上游依赖引入了同一坐标（group:module）的不同版本，麻烦就来了。Gradle 默认会采用一套“最近优先 + 最高版本胜出”的仲裁策略，但这套策略未必符合你的实际业务意图。你心里清楚，必须沿用 `my-dependency-1` 所携带的 `2.0.0`，而不是 `my-dependency-2` 带来的 `3.0.0`。
这时候，直接使用 `force true` 或者 `version { strictly '2.0.0' }` 这类静态硬编码方法就行不通了。为什么？因为它们无法感知到构建过程中，依赖图实际解析出的动态版本。正确的思路，是结合排除（exclude）策略、依赖图解析和构建时动态约束，来实现精准控制。
✅ 推荐方案：排除干扰项 + 利用依赖解析结果隐式锁定
首先得明确一点：Gradle 并没有提供一个直接的 DSL 方法，让你在 `build.gradle` 脚本的配置阶段就能“读取”到传递依赖的最终版本号。像 `configurations.compileClasspath.resolvedConfiguration` 这类对象，在配置阶段是尚未就绪的。不过别担心，我们完全可以通过另一条可靠的路径达成目标。
1. 显式排除冲突的传递依赖
dependencies {
implementation "my-dependency-1:module:1.0.0" // 自动带入 group:module:2.0.0
implementation("my-dependency-2:module:1.0.0") {
exclude group: "group", module: "module" // 阻断其引入的 3.0.0
}
}
✅ 这个操作的效果非常直接：`my-dependency-1` 所传递的 `group:module:2.0.0` 将成为该坐标的唯一来源；而 `my-dependency-2` 引入该坐标的路径被彻底切断，版本竞争自然也就消失了。
⚠️ 这里有个关键细节：`exclude` 必须写在带括号的闭包形式里（也就是 `implementation(...)` 这种写法），否则语法是无效的。同时，`group` 和 `module` 的名称必须严格匹配，注意大小写。
2. 进阶：通过 resolutionStrategy 强制统一版本（可选增强）
如果你希望约束更加健壮，比如防止未来其他依赖意外引入 `group:module` 的其他版本，可以在 `configurations` 中添加解析策略：
configurations.all {
resolutionStrategy {
force "group:module:2.0.0" // 全局强制指定版本
// 或更安全的写法：仅对特定配置生效
// force "group:module:2.0.0", configuration: "implementation"
}
}
⚠️ 需要注意的是，`force` 会覆盖所有来源的版本，适用于你已明确知道 `2.0.0` 是稳定版本的场景。但如果 `2.0.0` 本身是动态生成的（比如 `SNAPSHOT` 版本），那么更稳妥的做法还是以 `exclude` 为主，并在 CI 阶段进行依赖校验。
3. 验证：命令行查看实际解析结果
方案实施后，如何验证是否成功？执行下面的命令，可以清晰地看到最终的依赖解析结果：
./gradlew app:dependencies --configuration releaseRuntimeClasspath | grep "group:module"
在输出中，你应该只能看到 `group:module:2.0.0`，而找不到任何指向 `3.0.0` 的路径。这就表明排除操作成功了。
? 关键注意事项
- 不要在 dependencies 块中尝试调用 resolvedConfiguration：这是一个常见的误区。该对象在配置阶段尚未就绪，强行调用会导致 `NullPointerException` 或返回空集合。
- exclude 是声明式、轻量级且可预测的：与 `force` 相比，`exclude` 不会改变依赖图的整体语义，它只是精准地移除了指定的冲突路径，更符合“最小干预”的工程原则。
- 版本号需与实际发布一致：动手之前，最好去 Ma ven Repository 或 Google’s Ma ven Repo 确认一下，`group:module:2.0.0` 这个版本确实存在且可用。
- JCenter 已弃用：确保你的 `repositories` 配置中已经移除了 `jcenter()`，改用 `ma venCentral()` 或 `google()`（Android Studio 2021.3+ 版本已默认如此配置）。
✅ 总结
说到底，要“程序化获取并锁定某个传递依赖版本”，核心思路不是去“读取”它，而是去“引导”和“约束”整个依赖解析过程。通过 `exclude` 精准切断干扰源，让目标依赖成为该坐标的唯一供给者，是目前最简洁、最可靠、也最符合 Gradle 设计哲学的实践方式。它无需引入任何额外插件，不侵入构建生命周期，并且完全兼容 Android Gradle Plugin 8.0+ 及 Gradle 8.x，堪称企业级项目进行依赖治理的推荐范式。
WPS Office是一款面向macOS用户的综合办公套件，将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式，支持Intel及Apple芯片Mac，基础功能可免费使用，
Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核，支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换，并可通过账户在多台设备之间同步项目。
REAPER是Cockos开发的数字音频工作站，提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片，支持AU、VST、VST3、CLAP等插件格式，并提供高度可定制的工作流程。
Ableton Live 是面向音乐制作人与现场表演者的数字音频工作站，提供编曲视图、独具特色的现场视图、音频录制、MIDI创作、实时变速、乐器及效果器。Mac版原生支持Apple芯片，并可连接音频接口、MIDI控制器和第三方插件。
Adobe After Effects 是面向动态图形、影视特效与视频合成的专业创作软件。它提供关键帧动画、遮罩抠像、运动跟踪、三维空间、文字动画和表达式等工具，并可与 Premiere Pro、Photoshop、Illustrator
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Adobe Bridge 是面向摄影师、设计师及内容团队的免费数字资产管理工具，可集中预览照片、视频和 Adobe 项目文件，并利用评级、标签、关键词、元数据、筛选与收藏集完成分类检索。它还支持批量重命名、格式导出、相机导入及 Camera
Adobe Illustrator 是 Adobe 推出的专业矢量图形设计软件，适合在 Mac 上制作标志、图标、插画、包装、信息图及印刷版面。它以路径和锚点构建可无损缩放的图形，并提供钢笔、形状、文字、图像描摹、渐变、画板及生成式功能。
Adobe InDesign 是面向印刷品与数字出版物的专业版面设计软件，可在 Mac 上制作书籍、杂志、宣传册、海报、报告及交互式文档。它提供精细的文字样式、网格、母版、长文档管理和印前输出能力。
Adobe Lightroom Classic 是面向桌面摄影工作流的照片管理与后期处理软件，可将原始照片保存在本地硬盘，通过目录、关键词、评分和收藏夹高效整理图库，并提供 RAW 冲印、蒙版、镜头校正、批量同步及多格式导出等功能。
Adobe Media Encoder 是 Adobe 推出的专业音视频编码与转码工具，可通过队列、预设和监视文件夹批量完成格式转换、代理文件创建及多平台成片输出，并与 Premiere Pro、After Effects 等软件紧密协作。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理软件，提供图层、蒙版、选区、修复、调色、文字排版、智能对象及生成式编辑等能力。Mac 版支持 Intel 与 Apple Silicon 处理器。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理工具，可在 Windows 上完成照片修饰、选区抠图、图层合成、文字排版、绘画及生成式编辑。软件采用订阅授权，由 Creative Cloud 管理安装、更新与许
Adobe InDesign 是面向印刷与数字出版的专业页面排版工具，可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力，并能与 Photoshop、Illustrator
Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心，作品放大后仍能保持清晰，并提供画板、文字、渐变、图像描摹及精确变换等功能，适合品牌视觉、印刷物料、数字界面和商业插画创作。
Adobe Bridge 是 Adobe 推出的创意资产管理工具，可集中预览、分类和查找照片、视频、PDF及多种设计文件，并支持元数据、关键词、评级、批量重命名和格式导出。它可与 Photoshop、Illustrator 等应用衔接，
Affinity Photo 是一款面向摄影师、修图师和视觉设计人员的桌面图像编辑工具，提供 RAW 显影、多图层合成、蒙版、实时滤镜、批处理和色彩管理等功能。原独立产品已停止销售，其照片编辑能力已延续至免费的新 Affinity 应用；
Adobe Lightroom Classic 是面向 Windows 桌面摄影工作流的照片管理与无损编辑工具，可通过目录集中整理大型图库，并完成 RAW 显影、局部蒙版、批量调整、打印和多格式导出。它强调本地文件管理与精细控制，
Figma 是面向产品设计与开发团队的云端协作平台，可在 Windows 桌面客户端中完成界面绘制、组件管理、交互原型、评论评审和开发交付。文件保存在云端，多名成员能够同步编辑并共享设计系统；官方同时提供免费 Starter 方案及按席位计
Affinity Designer 是面向矢量图形、数字插画和界面设计的专业创作工具，可在矢量、像素与导出工作区之间快速切换。它提供曲线编辑、形状构建、画板、排版、图层和专业色彩管理，并支持常见设计文件的导入及多种印刷、网页格式输出。
Capture One Pro 是面向摄影师和影像团队的专业桌面照片处理工具，提供相机定制色彩配置、RAW转换、图层与蒙版、联机拍摄、目录及会话管理等功能。它适合棚拍、人像、商业产品、婚礼和风光摄影，
Adobe Acrobat Pro 是面向专业 PDF 工作的综合解决方案，可在 Windows 中创建、编辑、转换、比较、整理和保护文档，并支持表单、电子签名、扫描件文字识别及敏感信息永久遮盖。订阅还包含网页、移动服务和云端协作能力，
Adobe After Effects 是面向动态图形、动画与影视视觉特效制作的专业工具，可完成关键帧动画、图层合成、遮罩跟踪、抠像、文字动画和二维三维元素整合。Windows 版通过 Adobe Creative Cloud 安装及更新，
DaVinci Resolve是Blackmagic Design推出的一体化影视后期工具，将素材管理、非线性剪辑、专业调色、Fusion视觉特效、Fairlight音频处理和成片交付整合在统一工程中。免费版已覆盖多数个人创作需求，