本文详解 Gradle 中 repositories 和 dependencies 的正确配置位置，指出常见误区（如误写入 settings.gradle），并提供标准模块化配置方案，帮助开发者避免“Could not find method repositories()”等 DSL 错误。
本文详解 gradle 中 `repositories` 和 `dependencies` 的正确配置位置，指出常见误区（如误写入 `settings.gradle`），并提供标准模块化配置方案，帮助开发者避免“could not find method repositories()”等 dsl 错误。
在 Gradle 构建系统中，settings.gradle 和 build.gradle 承担截然不同的职责——混淆二者是导致构建失败的最常见原因之一。错误地将 repositories{} 或 dependencies{} 块写入 settings.gradle 文件，会直接触发 Could not find method repositories() 这类编译期 DSL 异常，因为 DefaultSettings 对象（即 settings.gradle 的上下文）不支持这些方法；它们仅对 Project 实例（即各模块的 build.gradle）有效。
✅ 正确分工如下：
- settings.gradle：定义多项目结构（如 include('lib')）、启用全局插件（如 JDK 工具链解析器）、设置根项目名称等跨项目配置；
- build.gradle（每个模块独立一份）：声明该模块所需的仓库源、依赖项、插件、Java 版本等构建逻辑。
以你提供的多模块项目为例（根项目 demo，子模块 lib），应严格按以下方式组织：
1. settings.gradle（精简、无依赖）
plugins {
id 'org.gradle.toolchains.foojay-resolver-convention' version '0.5.0'
}
rootProject.name = 'demo'
include('lib')
⚠️ 注意：此处不可出现 repositories{}、dependencies{}、apply plugin: 等模块级 DSL。
2. lib/build.gradle（模块专属构建脚本）
plugins {
id 'java-library' // 启用 Java 构建功能（含 dependencies 支持）
}
repositories {
mavenCentral() // 声明依赖解析仓库
}
dependencies {
implementation 'com.google.auto.service:auto-service:1.1.1' // 添加运行时依赖
// testImplementation 'junit:junit:4.13.2' // 示例：测试依赖可在此添加
}
? 关键前提与验证建议：
- 确保 Gradle 版本 ≥ 7.6.1（推荐使用 8.4+），旧版本可能不兼容 foojay-resolver-convention 插件或现代 DSL；
- 运行 ./gradlew --version 检查当前环境；
- 若需为所有子模块统一配置仓库，可在根项目 build.gradle（而非 settings.gradle）中使用 subprojects { } 闭包，但通常更推荐模块自治；
- 依赖作用域需精准选择：implementation（编译+运行）、api（透出给上游）、compileOnly（仅编译期）等，避免传递性污染。
执行 ./gradlew build 后，Gradle 将成功解析 Maven Central 上的 auto-service 库，并完成编译与测试流程。牢记：配置即契约——把 DSL 放在它被设计接纳的地方，是构建稳定性的第一道防线。
