IntelliJ IDEA中Android SDK安装异常排查及解决求助

先给你讲清楚IDEA检测Android SDK是否安装的核心机制，再一步步解决你的问题：

IDEA检测Android SDK的机制 #

IDEA判断SDK是否安装主要依赖以下几个维度：

• 全局配置文件记录：IDEA会在自身的配置目录中存储你之前设置的SDK路径信息，哪怕你手动删除了SDK目录，只要配置文件里的路径记录没清除，IDEA就会认为SDK还在。
• 系统环境变量：如果系统中设置了ANDROID_HOME或ANDROID_SDK_ROOT环境变量，IDEA会优先读取这个变量指向的路径，哪怕该路径是空的或不存在，也可能触发误判。
• 项目级配置：如果之前打开过Android项目，项目根目录的.idea/misc.xml文件中会保存该项目关联的SDK路径，打开项目时IDEA会加载这个配置。

分步解决方法 #

1. 清除IDEA全局SDK配置 #

• 完全关闭IntelliJ IDEA，确保后台没有残留进程。
• 根据你的操作系统找到对应的IDEA配置目录：
  • Windows：C:\Users\<你的用户名>\AppData\Roaming\JetBrains\<IntelliJ IDEA 版本号>（比如IntelliJ IDEA 2023.2）
  • macOS：~/Library/Application Support/JetBrains/<IntelliJ IDEA 版本号>
  • Linux：~/.config/JetBrains/<IntelliJ IDEA 版本号>
• 进入options子目录，删除android.sdk.xml和android.sdk.plugins.xml这两个文件（如果存在的话）。
• 重新启动IDEA，进入File > Project Structure > SDKs，此时IDEA应该会提示未配置Android SDK，你可以指定新的安装路径，重新启动安装流程。

2. 检查并修正系统环境变量 #

• 打开系统环境变量设置：
  • Windows：右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  • macOS/Linux：编辑用户目录下的~/.bash_profile、~/.zshrc（根据你用的shell），或者系统级环境变量文件
• 查找是否存在ANDROID_HOME或ANDROID_SDK_ROOT变量：
  • 如果有，要么直接删除这两个变量；要么把变量值修改为你准备重新安装SDK的空目录路径。
• 保存修改后，重启IDEA生效。

3. 清理旧项目的本地配置（如果涉及旧项目） #

• 如果你打开的是之前的Android项目，先关闭IDEA。
• 找到项目根目录下的.idea文件夹，删除其中的misc.xml文件；或者打开misc.xml，找到<component name="AndroidSdkSettings">相关的配置段，删除里面的SDK路径配置。
• 重新打开项目，IDEA会重新引导你配置Android SDK。

4. 确保安装路径的权限 #

• 选择SDK安装路径时，尽量避开系统受保护目录（比如Windows的C:\Program Files），优先选择用户目录下的路径（比如C:\Users\<你的用户名>\Android\Sdk）。
• 确保该路径有读写权限，避免安装过程中因权限问题导致异常。

内容的提问来源于stack exchange，提问作者midpush