你是不是也遇到过这种情况Android Studio 正好好地编译着项目突然弹出一行红色报错内容大致是failed to load include path ...\platforms\android-35\android.jar紧接着整个项目就像被按了暂停键代码提示失效、Gradle 同步失败点哪哪转圈。我第一次碰到的时候也懵了满脑子都是“我昨天还能跑今天怎么就不行了”。先说结论这个报错不是你代码写错了而是 Android Studio 在加载编译用的 SDK 平台包时出了问题。简单来说android-35对应的android.jar文件缺失、路径对不上或者 IDE 缓存里的索引坏了。它更像是一个“环境型”报错虽然看着吓人但解决起来并不复杂。这篇文章我会从问题本质讲起把网上零零散散的方案整合成一套完整、可落地的排查流程覆盖 90% 以上的出错场景不管你是刚装完 Android Studio 的新手还是被这个问题折腾半天的老开发按顺序操作基本都能搞定。1. 先别慌这个报错到底在说什么1.1 一个 include path牵扯出整个编译链路failed to load include path这句话拆开看重点在include path和后面的具体路径。在 Android 开发里IDE 并不是简单地“打开一个项目”它要先把项目的编译环境准备好其中最关键的一步就是加载 Android SDK 里的平台库。路径...\platforms\android-35\android.jar指的是 Android 15API 35的 SDK Platform 包。android.jar是 Android 系统的核心库里面包含了所有的 API 接口定义。IDE 加载这个文件才能给你提供代码补全、语法检查、编译校验这些功能。所以当报错说“failed to load include path”时实际含义就是IDE 尝试加载这个核心库但没有成功。我见过不少人把这个问题误判成代码问题反复修改 Kotlin 或 Java 文件结果毫无变化。如果你也在这个方向上浪费时间请立刻停下来问题根本不在你的业务代码里。1.2 为什么偏偏是 android-35 出了问题主要有三方面原因。第一android-35这个平台包根本没有安装到本机的 SDK 目录里或者安装了一半、解压不完整。第二SDK 目录位置不对IDE 按默认路径找不到这个包比如你之前手动移动过 SDK 目录。第三Gradle 缓存和 IDE 索引记住了某个“失效”的路径即使文件存在也加载不进来。还有一种特殊情况是你用的 Android Studio 版本太老内置的 AGPAndroid Gradle Plugin不支持 compileSdk 35这时候 IDE 也会尝试去找但它根本不认识这个平台版本。搞清楚这些原因之后下面的解决方案就很好理解了本质上就是“补文件、纠正路径、清缓存”这三步。2. 最基础的解法检查 SDK Platform 35 是否真的装了2.1 打开 SDK Manager 手动勾选平台包在 Android Studio 的欢迎页或者主界面找到顶部菜单栏的Tools SDK Manager。如果你的界面是英文那就是Tools SDK Manager如果是汉化版在“工具”菜单里找“SDK 管理器”。打开之后会有一个SDK Platforms标签页这里列出了所有可安装的 Android 平台版本。你要找的是Android 15 (API 35)这一项看清楚前面的复选框状态如果没勾选说明平台包没装如果勾选但显示灰色说明安装了但路径有问题。正确操作是勾选上Android 15 (API 35)然后点右下角的Apply按钮。接下来会弹出一个选择协议确认的窗口勾选同意之后点击Next开始下载。这个下载过程取决于网络情况包大小大概在 40-60MB正常情况下几分钟就能完成。下载完成后最好重启一下 Android Studio再让项目重新同步一次。这里要特别提醒一句下载完成后不要急着关闭窗口务必看一下底部日志输出是否显示Done或者没有红色错误信息。很多人点了 Apply 之后以为下载完了其实中途网络波动断掉了SDK 目录里留下一个不完整的文件反而更容易触发后续问题。2.2 一行命令验证 android.jar 是否真实存在图形界面有时候会“撒谎”最可靠的办法是直接去 SDK 目录里看文件。我习惯用命令行验证因为路径可以复制不用一个个文件夹点进去。Windows 用户在 CMD 或 PowerShell 里输入dir %LOCALAPPDATA%\Android\Sdk\platforms\android-35\android.jarmacOS 或 Linux 用户在终端里输入ls $HOME/Library/Android/sdk/platforms/android-35/android.jar如果返回了文件的详细信息说明平台包安装完整。如果提示系统找不到指定的路径或者No such file or directory那就验证了我的判断android-35 根本没装好。有些朋友可能会问我用的 SDK 路径不是默认的怎么办很简单打开项目的local.properties文件里面有一行sdk.dir你的SDK路径把那个路径替换到命令里就行。关于local.properties在下一节会重点讲。3. 路径对不上三步矫正 SDK 位置3.1 检查 local.properties 里的 sdk.dirlocal.properties是 Gradle 读取本地 SDK 路径的核心配置文件它位于项目的根目录不在代码仓库的版本控制里通常被 .gitignore 忽略。如果你是从别人那里克隆的项目或者你自己手动移动过 Android Studio 的 SDK 目录这个文件里的路径就可能是错的。用文本编辑器打开它找到sdk.dir这一行。Windows 系统下路径分隔符要用双反斜杠或者正斜杠比如sdk.dirC:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk或者sdk.dirC:/Users/你的用户名/AppData/Local/Android/SdkmacOS 下类似sdk.dir/Users/你的用户名/Library/Android/sdk确认这个路径和实际 SDK 所在位置一致。如果文件里根本没有这行你可以手动加上保存后回到 Android Studio点击菜单栏File Sync Project with Gradle Files让项目重新读取配置。这个文件是项目级别的也就是说你有多个项目的话每个项目都有自己的一份local.properties。我见过有人只修了一个项目换另一个项目还报错就觉得方案无效实际上每个项目都要单独排查一遍。3.2 在 Project Structure 里重新指定 SDK 路径比手动改配置文件更直观的方法是通过 IDE 的图形界面操作。点击菜单栏File Project Structure快捷键 CtrlAltShiftS左侧选择SDK Location你会在右侧看到一个 SDK 路径输入框。这里有两个信息要仔细看Android SDK location和下面的JDK location。很多人的 Android SDK 是好的但 JDK 路径被误改成了不存在的目录同样会导致一系列诡异报错。建议直接把 Android SDK 路径重新浏览选择一次即使它看起来是对的也重新选一下让 IDE 强制刷新一次。选好之后点Apply或者OK关闭窗口后 IDE 可能会要求你重新同步项目同意即可。这个操作本质上是在修改 Android Studio 的全局配置优先级比local.properties高但是 Gradle 同步时又会参考local.properties所以两个地方最好保持一致。我的习惯是两处都检查确保双保险。3.3 多 SDK 版本并存时的路径优先级有些开发者的电脑上可能装了多个 SDK比如一个是 Android Studio 自带的一个是通过命令行工具单独下载的还有一个是以前配环境变量时手动解压放在别的盘里的。这种情况下路径优先级就容易混乱。Android Studio 在加载 SDK 时会按这个顺序查找local.properties里的sdk.dir→ Android Studio 设置里的 SDK Location → 系统环境变量ANDROID_HOME。如果你发现路径改来改去还是报错可以打开系统环境变量看一眼ANDROID_HOME和ANDROID_SDK_ROOT是否指向了一个不存在的目录。Windows 用户在命令行输入echo %ANDROID_HOME%macOS/Linux 用户输入echo $ANDROID_HOME看看返回结果。如果指向失效路径直接删掉或改成正确路径然后重启 Android Studio。这里有个经验之谈环境变量里的路径最好是 SDK 的实际安装位置不要为了省事指到上一级目录。4. Gradle 缓存和 IDE索引抽风重置大法4.1 先清 Gradle 缓存再同步如果 SDK 文件明明存在路径也对但报错依旧那大概率是 Gradle 缓存里存了过期的路径信息。Gradle 会把项目的依赖、构建状态缓存到本地有时候这些缓存会保存一些“旧世界”的路径即使你已经改了配置它还是按老地址去加载。操作流程先关闭 Android Studio 项目窗口打开文件管理器或者终端进入.gradle目录。Windows 在用户目录下的.gradle\cachesmacOS 是~/.gradle/caches。直接删掉整个caches文件夹或者更彻底一点删掉整个.gradle目录。然后重新启动 Android Studio打开项目点击同步。第一次同步时 Gradle 会重新下载依赖时间可能比较长建议保持网络稳定。这个方法虽然粗暴但确实能解决一大半“玄学”报错尤其是当你做过 SDK 目录迁移之后。不过要提醒一下删除 Gradle 缓存意味着所有项目的依赖都要重新下载如果你有十几个项目每个项目的依赖各不相同重建缓存的时间会相当可观。更温和的做法是先只删除caches\modules-2\files-2.1\com.android.tools.build下与 AGP 相关的缓存通常能精准解决这类加载失败。如果没效果再放大到整个 caches。4.2 Invalidate Caches 的时机与正确姿势Android Studio 基于 IntelliJ 平台开发它有自己的索引系统会把文件路径、类定义、资源信息建立成索引用来加快搜索和代码补全。这个索引偶尔会“抽风”记录下一些错误的路径映射导致即使文件存在也加载不上。当你遇到“文件在路径也对缓存也清了但还是报错”的情况就可以祭出File Invalidate Caches / Restart。点击之后会弹出一个窗口问你是否要Clear file system cache and Local History建议勾选上后面的 checkbox这样会连同本地历史一起清掉更彻底。确认后会重启 Android Studio之后它会重新建立整个项目的索引这个过程可能需要几分钟期间 CPU 占用会很高属于正常现象。等右下角进度条跑完再同步 Gradle。需要注意的是清完索引后第一次解析代码会比较慢不要以为是死机了。4.3 终极核弹删除 .gradle 与 .idea 后重导项目如果前面所有方法都试过了还是不解决问题那就用最后一招删除项目目录下的.gradle和.idea文件夹。.gradle存的是项目级别的构建缓存.idea存的是 IDE 的项目配置文件包括模块配置、运行配置、SDK 关联等。操作前先备份一下毕竟项目配置文件里可能有一些你没记住的个性化设置。备份方式很简单把.idea复制一份改名为.idea.bak放旁边确认没问题后再删。具体操作关闭 Android Studio回到项目根目录删除.gradle和.idea两个文件夹重新打开项目。这时候 Android Studio 会像第一次打开项目一样重新扫描整个项目结构重新生成配置文件。缺陷是项目里的运行配置、代码风格设置、版本控制绑定可能全部丢失需要重新配置一遍。但优势也很明显它能解决几乎所有由项目级配置损坏引起的问题。这个“核弹”我一般留到最后因为成本不小。但如果你已经折腾了一整天与其继续猜不如干脆重来一遍。5. 命令行精确诊断不让 Android Studio 背锅5.1 用 sdkmanager 确认平台包状态Android SDK 自带了一个命令行工具sdkmanager它可以列出所有已安装 SDK 组件的真实状态。这个工具的位置在你的 SDK 目录下的cmdline-tools\latest\bin里面Windows 是sdkmanager.bat。先检查已安装平台包sdkmanager --list_installed系统会输出所有已安装的 SDK 组件你要找的是platforms;android-35这一行。如果列表里没有它说明真的没装如果有但是 IDE 还报错那问题就偏向路径配置或缓存。直接安装它sdkmanager platforms;android-35这个过程会在终端里显示下载进度你能直观看到是否卡住或者中断。安装完成后再次执行sdkmanager --list_installed确认。注意一个细节Windows 系统下sdkmanager命令不能直接在 CMD 里运行要先切换到该工具所在目录或者把路径加到系统 PATH 里。不然会出现“不是内部或外部命令”的尴尬。5.2 创建测试项目验证 SDK 本身是否正常有时候问题不一定出在你的项目配置上而是 IDE 本身跟 SDK 的交互出了问题。这时候可以创建一个全新的空白项目来验证。如果新项目的compileSdk设为 35 能正常运行说明 SDK 和 IDE 的环境是好的问题出在原来的项目配置上如果新项目也报同样的错误那基本可以断定是 IDE 或 SDK 层面的问题。创建时有一个小技巧在向导页面直接把Minimum SDK随便选一个Language选 Kotlin 或 Java 都行关键是项目创建完成后打开build.gradle.kts或build.gradle看一眼compileSdk是否是 35。如果不是 35改一下重新同步看看会不会报同样的错误。这个测试能帮你精准定位问题归属省去在错误方向上的无用功。我之前就遇到过SDK 完全正常但项目 build 文件里混入了某个不兼容插件导致路径加载失败。通过新项目对比很快就发现了问题源头比在那瞎猜高效得多。5.3 诊断结果对照不同错误变体的处理方向“failed to load include path”在实际项目中可能会以几种不同形态出现我把常见变体和处理方向整理成了一张表方便你对照排查。错误信息特征最可能的根因优先尝试的方案failed to load include path ...android-35\android.jarSDK Platform 35 未安装或路径错误安装平台包、修正路径failed to find target with hash string android-35Gradle 感知的 SDK 平台与已安装的不匹配在 SDK Manager 中安装对应 API 35failed to load SDK后面跟一串路径SDK 目录整体失效检查 local.properties、Project Structureunable to find valid certification path在同步中出现Gradle 依赖下载被网络拦截配置镜像源或使用代理注意合规使用could not determine the dependencies of task :app:compileDebugJavaWithJavacandroid.jar 未完整加载清 Gradle 缓存、重新同步6. 养成三个习惯少踩一半环境坑6.1 每次升级 Android Studio 后主动校验 SDK 平台Android Studio 升级是个高频踩坑节点尤其跨大版本升级的时候IDE 可能默认采取新的 SDK 路径策略或者旧配置不兼容。我的习惯是升级完成后先打开 SDK Manager 看一眼有没有平台包被标记成“已安装但损坏”或者有没有提示需要更新平台工具。另外一个容易被忽略的点Android Studio 版本和 AGP 版本有兼容性要求。比如新版 AS 可能要求使用至少某个版本的 AGP而老项目里 AGP 版本过低就会造成加载 SDK 平台时失败。遇到升级后报错第一时间检查build.gradle里的 AGP 版本号去官网查一下兼容对照表。6.2 新拉取项目先看 compileSdk 再同步从 Git 仓库拉取别人项目的时候别急着同步。先花十秒钟打开项目根目录的build.gradle或者build.gradle.kts找到compileSdk这一行看看是多少。如果项目的 compileSdk 是 35而你的 SDK 里连 34 都没装同步必然报错。这时候你有两种选择第一种直接把 compileSdk 改成你已有的 API 版本改完后同步这种适合项目对 API 版本不敏感的情况第二种在 SDK Manager 里安装对应平台最稳妥推荐给想保持项目原样的做法。养成这个习惯你会少遇到很多“莫名其妙”的路径报错。6.3 善用命令行工具替代图形界面图形界面好看但很多时候不如命令行直观高效。sdkmanager不仅能看已安装列表还能精确安装指定组件不怕中途点错按钮。当 IDE 的 SDK Manager 卡死或者漏装时命令行工具就是最好的备用手段。此外SDK 目录\build-tools\下有一个aapt2.exemacOS 是aapt2它是 Android 资源打包工具。如果你遇到的报错跟资源加载相关可以用命令手动验证一下 build-tools 是否完整。总之掌握几个常用命令行工具等于给自己配了一把“环境问题专用钥匙”。7. 常见问题速查表按报错关键词定位这里把大家问得最多的几个场景整理成速查表你可以直接按关键词定位到对应解法。现场症状排查顺序备注报错只出现在android-35其他 apiLevel 正常1. 检查是否安装了 Platform 352. 手动通过命令行安装极大概率是平台包未安装同一个项目在同事电脑上正常自己电脑报错1. 对比local.properties路径差异2. 检查环境变量ANDROID_HOME重点看 SDK 路径是否存在解决方案都试了重启后报错又回来1. 检查 Android Studio 的 SDK Location2. 删除 .idea 重新导入项目项目配置文件可能“记住”了错误状态同步 Gradle 时提示connection reset或下载失败1. 配置镜像仓库2. 检查依赖源配置属于网络问题和 android.jar 无关新建项目正常旧项目报错1. 对比两个项目的 AGP 版本2. 检查项目里是否有特殊配置大概率是项目级配置问题不是 SDK 全局问题最后再分享一个实用的小技巧报错信息里有时会包含具体的文件行号比如...(项目路径): line xx。这个行号一般指向build.gradle中声明 compileSdk 的位置。我遇到过一次把 compileSdk 从 35 改成 33 后问题立刻消失查了半天才发现是某个老插件不支持 API 35 的构建。如果你项目里插件比较老旧可以适当降级 compileSdk等后续升级插件之后再升回去这也是一种务实的处理策略。我自己处理这类环境问题有个原则先看文件存不存在再看路径对不对最后才动缓存。按这个顺序来每一步都有明确目的不会像无头苍蝇一样乱试。这次遇到failed to load include path本质上就是把“SDK 平台包”这个基础工作补到位大部分情况都能迎刃而解。