Android Studio安装SDK遇多类错误 求可行解决方案

一、彻底清理旧SDK残留（关键前置步骤） #

• 卸载Android Studio，删除所有相关残留目录：
  • Windows：C:\Users\<你的用户名>\.android、C:\Users\<你的用户名>\.gradle、C:\Program Files\Android
  • macOS：~/Library/Android、~/.android、~/.gradle
  • Linux：~/Android、~/.android、~/.gradle
• 重启电脑，确保残留文件完全清除

二、重新安装并指定合规SDK路径 #

• 下载最新稳定版Android Studio，安装时绝对不要把SDK路径设为文件系统根目录，推荐路径示例：
  • Windows：D:\Android\SDK
  • macOS：~/Documents/Android/SDK
  • Linux：~/Android/SDK
    路径中禁止出现中文、空格或特殊字符（比如!@#）
• 启动安装向导时选择「Custom」模式，手动勾选以下核心组件：
  • Android SDK Platform（选最新稳定版，如Android 14）
  • Android SDK Build-Tools（匹配对应平台版本）
  • Android Emulator
  • Intel x86 Emulator Accelerator（HAXM，Windows/macOS）或KVM（Linux）

三、手动修复模拟器目录缺失问题 #

如果安装后仍提示SDK emulator directory is missing：

1. 打开Android Studio的「Settings」（Windows：File > Settings；macOS：Android Studio > Settings）
2. 进入「Appearance & Behavior > System Settings > Android SDK」
3. 切换到「SDK Tools」标签，勾选「Show Package Details」
4. 展开「Android Emulator」，勾选最新版本，点击「Apply」重新安装
5. 检查SDK路径下是否存在emulator目录，若不存在则手动创建，之后重启Android Studio

四、修复权限与环境变量 #

• 权限修复：
  • Windows：右键以管理员身份运行Android Studio，同时给SDK目录赋予完全控制权限（右键目录 > 属性 > 安全 > 选择当前用户 > 勾选「完全控制」）
  • macOS/Linux：打开终端执行sudo chmod -R 755 <你的SDK路径>，赋予目录读写权限
• 环境变量配置：
  • Windows：添加系统变量ANDROID_HOME，值为你的SDK路径；将%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\emulator添加到Path变量中
  • macOS/Linux：在~/.bashrc或~/.zshrc中添加：

    export ANDROID_HOME=<你的SDK路径>
    export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator
    

    执行source ~/.bashrc（或对应配置文件）使配置生效

五、强制刷新SDK组件 #

1. 关闭Android Studio，进入SDK目录下的tools/bin文件夹
2. 执行对应命令查看已安装组件：
   • Windows：sdkmanager --list
   • macOS/Linux：./sdkmanager --list
3. 强制安装缺失组件（替换为你需要的版本）：
   • Windows：sdkmanager --install "emulator" "platform-tools" "platforms;android-34"
   • macOS/Linux：./sdkmanager --install "emulator" "platform-tools" "platforms;android-34"
4. 安装完成后重启Android Studio

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