fileTree是Gradle中用于批量导入本地文件（如libs目录下所有.jar）的声明式依赖配置方式，通过dir指定相对路径、include指定通配符模式实现扫描匹配，需置于dependencies块内且不可与files混用。
使用 fileTree 是最直接的方式
Gradle 没有“批量导入”这个独立语法，但 fileTree 就是为此设计的——它本质就是扫描目录、匹配文件名模式、生成依赖集合。只要 libs 目录下全是 .jar，一行配置就能覆盖全部。
在 build.gradle 的 dependencies 块中写：
implementation fileTree(dir: 'libs', include: ['*.jar'])
注意三点：
-
dir必须是相对于当前build.gradle文件的路径（比如你在app/build.gradle里写，libs就得在app/libs下） -
include是字符串列表，支持通配符；写成['*.jar', '*.zip']也能同时抓 zip，但一般不建议混用 - 不要漏掉单引号，
['*.jar']是 Groovy 列表字面量，写成["*.jar"]也行，但双引号在某些旧版本 Gradle 中可能触发变量插值导致意外行为
fileTree 和 files 的关键区别
files('libs/a.jar', 'libs/b.jar') 是显式列出每个文件，适合只引入几个特定 jar；而 fileTree 是声明式扫描，适合“所有 jar 都要”。两者不能混用在同一行，但可以共存于同一 dependencies 块中。
常见误用：
- 写成
implementation fileTree('libs')—— 缺少include参数，Gradle 会报错Could not find method fileTree() for arguments [libs] - 把
fileTree放在repositories块里 —— 它只在dependencies中有效，repositories是管“从哪下载”，不是“本地放哪” - 期望
fileTree自动递归子目录 —— 默认不递归，如需，加recursive: true参数，但多数项目不需要，且容易引入测试用 jar 或重复包
Android 项目中 libs 路径容易错位
Android Studio 的模块结构常让人混淆 libs 应该放在哪。正确位置取决于你编辑的是哪个 build.gradle：
- 如果你改的是
app/build.gradle，libs必须在app/libs/下 - 如果你改的是根目录的
build.gradle（老项目或聚合项目），那libs得放在项目根目录，且需配合allprojects { repositories { flatDir { dirs 'libs' } } }，但这种写法已不推荐，易污染全局 - IDE 右键 “Add as Library” 生成的
compile files(...)是绝对路径或相对路径硬编码，和fileTree不兼容，同步前务必删掉这类残留行
真正麻烦的从来不是怎么写这行代码，而是 jar 包之间隐含的传递依赖冲突——比如两个 jar 都打包了不同版本的 commons-lang3，运行时可能 NoClassDefFoundError 或方法签名不匹配。这时候 fileTree 反而掩盖了问题，因为它不解析 jar 内容，只做文件级引用。
