在 Gradle 中用 flatDir 引入本地 JAR 包，需先在项目根目录创建 libs 文件夹并放入 JAR，再在 repositories 中配置 flatDir { dirs 'libs' }，然后在 dependencies 中以 implementation name: 'xxx' 方式声明依赖，最后清理旧 fileTree 配置并同步 IDE。

在 Gradle 中用 flatDir 引入本地 JAR 包，核心是把存放 JAR 的目录注册为本地仓库，并通过命名依赖方式声明引用。这种方式比直接用 fileTree 更可靠，能让 IDE 正确识别类、支持代码补全，也避免运行时 ClassNotFoundException。

1. 创建并放置 JAR 文件

在项目根目录（即 build.gradle 所在位置）下新建文件夹，比如 libs，把你要用的 JAR 文件放进去。例如：

• ./libs/my-utils.jar
• ./libs/legacy-api.jar

路径必须是相对项目根目录的，不要用绝对路径。

2. 配置 flatDir 仓库

在 build.gradle 的 repositories 块中添加 flatDir 声明：

repositories {
    mavenCentral()
    flatDir {
        dirs 'libs'  // 注意：这里写的是文件夹名，不是完整路径
    }
}

如果 JAR 在 app/libs 下，就写 dirs 'app/libs'；如果在 project/libs，就写 dirs 'libs'。

Gradle 9.8.0

下载

3. 声明命名依赖

在 dependencies 块中，用 name 参数引用 JAR，不带后缀、不带版本号：

dependencies {
    implementation name: 'my-utils'     // 对应 my-utils.jar
    implementation name: 'legacy-api'   // 对应 legacy-api.jar
}

名称必须与文件名完全一致（包括大小写），不能写成 my-utils.jar 或 my-utils-1.2.0。

4. 清理旧配置并同步 IDE

确保已移除类似下面的旧写法，避免冲突：

• implementation fileTree(dir: 'libs', includes: ['*.jar'])
• compile files('libs/xxx.jar')

改完 build.gradle 后，在 IntelliJ IDEA 中点击右上角的 Reload project（或 Gradle 工具窗口里的刷新按钮），否则 IDE 不会更新索引，类仍然无法识别。