macos 上 android sdk 长期升级后会积累大量过时的 build-tools、platform-tools、ndk、cmake 和系统镜像，占用磁盘空间并引发构建问题；可通过 android studio gui 卸载、手动删除目录、精准清理 ndk/cmake/platforms/system-images，或运行安全脚本识别非活跃版本。
如果您在 macOS 上长期使用 Android SDK 进行开发，随着多次升级，SDK Manager 会保留下大量已过时的构建工具（如 build-tools）、平台工具（platform-tools）、NDK、CMake 及系统镜像等旧版本文件，这些文件不仅占用可观磁盘空间，还可能引发版本冲突或构建异常。以下是多种可独立执行的清理方法，覆盖图形界面操作、终端命令及安全筛选策略。
一、通过 Android Studio SDK Manager 卸载旧版工具
该方法由 IDE 原生提供，具备版本依赖检测能力，能自动识别并禁用被当前项目引用的旧工具，仅允许卸载未被任何项目使用的冗余版本，安全性高且无需记忆路径。
1、启动 Android Studio，确保已打开任意项目或处于欢迎界面。
2、点击顶部菜单栏 Preferences → Appearance & Behavior → System Settings → Android SDK。
3、切换至 SDK Tools 选项卡，并勾选右下角 Show Package Details。
4、展开 Android SDK Build-Tools、NDK (Side by side)、CMake 等条目。
5、取消勾选所有标有 (obsolete) 的版本，保留当前项目 build.gradle 中指定的最低版本及最新稳定版。
6、点击 Apply，确认卸载操作并等待下载/删除完成。
二、手动删除特定旧版 build-tools 目录
该方法适用于 SDK Manager 未正确识别废弃版本、或需批量清除多个历史 build-tools 子目录的情形；直接作用于文件系统，不依赖 IDE 状态，但需谨慎核对路径与版本号。
1、确认 Android SDK 根目录路径，通常为 ~/Library/Android/sdk；可通过终端执行 echo $ANDROID_HOME 验证。
2、进入 build-tools 目录：cd ~/Library/Android/sdk/build-tools。
3、列出全部子目录：ls -l，识别形如 30.0.3、29.0.2 的旧版本号。
4、逐个删除指定旧版本（以 28.0.3 为例）：rm -rf 28.0.3。
5、若需批量清理除最新两个版本外的所有旧版，可执行：ls -t | tail -n +3 | xargs rm -rf（请先备份或测试命令输出）。
三、清理过时的 NDK 和 CMake 版本
NDK 与 CMake 各自维护独立版本目录，长期积累后易产生数十 GB 冗余；此方法通过定位其安装路径并按需删减，避免误删正在使用的版本。
1、进入 NDK 安装目录：cd ~/Library/Android/sdk/ndk，查看子目录列表。
2、保留当前项目 app/src/main/cpp/CMakeLists.txt 或 build.gradle 中声明的 NDK 版本（如 25.1.8937393），其余旧版执行 rm -rf [version]。
Android 开发调试技能，通过系统 ADB 工具操作 Android 设备。以下场景必须触发此技能：(1) 直接 ADB 操作——安装 APK、查看设备列表、抓取 logcat 日志、查看已安装应用、清除应用数据、截图、重启设备、拉取/推送文件、查看 CPU/内存/电池信息、adb shell 操作；(2)...
3、进入 CMake 目录：cd ~/Library/Android/sdk/cmake，同样比对 externalNativeBuild 配置中指定的版本。
4、删除未被引用的 CMake 子目录，例如：rm -rf 3.10.2.4988404。
5、如需彻底清空 CMake 缓存（不影响已安装版本），可额外执行：rm -rf ~/.cmake。
四、移除不再需要的 Android 平台（platforms）和系统镜像（system-images）
每个 Android API 级别对应一个 platforms 子目录，而 system-images 则包含大量模拟器镜像文件；二者均按版本独立存储，旧版本常被忽略却持续占用空间，本方法聚焦精准剔除。
1、进入 platforms 目录：cd ~/Library/Android/sdk/platforms，运行 ls 查看已安装 API 级别（如 android-33、android-30）。
2、检查当前项目 build.gradle 中的 compileSdk 与 targetSdk 值，仅保留 ≥ 该值的两个最近版本（如项目使用 34，则保留 android-34 与 android-33）。
3、删除其他旧 platforms 目录，例如：rm -rf android-29。
4、进入 system-images 目录：cd ~/Library/Android/sdk/system-images，按层级结构识别冗余组合（如 android-28/google_apis/x86_64）。
5、删除所有未在 AVD Manager 中注册、且无对应运行中模拟器的 system-images 子目录。
五、使用终端脚本自动化识别并清理非活跃 SDK 工具
该方法通过解析本地项目配置与 SDK 目录结构，生成待清理项清单，规避人工误判；脚本不自动执行删除，仅输出建议命令供审核后执行，兼顾效率与安全性。
1、新建脚本文件：touch ~/clean-sdk-old-tools.sh。
2、编辑脚本：nano ~/clean-sdk-old-tools.sh，粘贴以下内容：
#!/bin/bash
SDK_ROOT="${ANDROID_HOME:-$HOME/Library/Android/sdk}"
echo "Scanning SDK tools in: $SDK_ROOT"
echo "--- Build-Tools versions in use ---"
grep -r "buildToolsVersion\|build-tools" ~/AndroidStudioProjects/*/build.gradle* 2>/dev/null | grep -oE "[0-9]+\.[0-9]+\.[0-9]+" | sort -u
echo "--- Current NDK version from projects ---"
grep -r "ndkVersion\|ndk.dir" ~/AndroidStudioProjects/*/local.properties 2>/dev/null | grep -oE "[0-9]+\.[0-9]+\.[0-9]+" | sort -u
3、赋予执行权限：chmod +x ~/clean-sdk-old-tools.sh。
4、运行脚本：~/clean-sdk-old-tools.sh，记录输出中显示的“in use”版本。
5、对比 $SDK_ROOT/build-tools 和 $SDK_ROOT/ndk 中实际存在的目录，手动构造 rm -rf 命令清理未出现在输出中的旧版。
