如何将Gradle、AVD及其他Android相关目录迁移至外接SSD?
如何将Gradle、AVD及其他Android相关目录迁移至外接SSD?
兄弟我太懂你这种M2 MacBook 256G的痛了!Android相关的缓存和目录简直是空间杀手,我之前也折腾过把这些目录移去外接SSD,亲测可行,给你一步步说怎么操作:
一、先做2个关键准备
- 把外接SSD格式化成APFS格式(Mac下兼容性最好,读写速度也稳),已格式化好的跳过这步
- 关闭所有Android Studio、Gradle相关进程,避免操作时文件被占用导致出错
二、迁移Gradle缓存目录(~/.gradle)
这个目录存的是Gradle的编译缓存,动辄几十G:
- 在外接SSD根目录创建目标文件夹,比如我建的是
/Volumes/你的SSD名称/AndroidData/.gradle - 打开终端,把原目录整体移动到SSD:
mv ~/.gradle /Volumes/你的SSD名称/AndroidData/ - 创建符号链接,让系统仍能通过原路径访问SSD上的目录:
ln -s /Volumes/你的SSD名称/AndroidData/.gradle ~/.gradle - 验证:终端输入
ls -l ~/.gradle,显示路径指向SSD目录即为成功
三、迁移Android SDK目录(~/Library/Android)
这是占空间最大的目录,包含SDK包、模拟器镜像等:
- 在SSD创建目标目录,比如
/Volumes/你的SSD名称/AndroidData/Android - 移动原目录:
mv ~/Library/Android /Volumes/你的SSD名称/AndroidData/ - 创建符号链接:
ln -s /Volumes/你的SSD名称/AndroidData/Android ~/Library/Android - 确认:打开Android Studio,到
Settings > Appearance & Behavior > System Settings > Android SDK,会自动识别到SSD上的SDK路径
四、迁移.android配置目录(~/.android)
这个目录存了AVD模拟器配置、密钥库等内容:
- 在SSD创建目标目录
/Volumes/你的SSD名称/AndroidData/.android - 移动原目录:
mv ~/.android /Volumes/你的SSD名称/AndroidData/ - 创建符号链接:
ln -s /Volumes/你的SSD名称/AndroidData/.android ~/.android
五、几个避坑提醒
- 每次开发前务必确保外接SSD已挂载,否则Android Studio会找不到目录,甚至自动生成空的原目录,到时候得重新链接
- 若后续更换SSD或修改目录名,先删除旧链接(比如
rm ~/.gradle),再重新创建新的符号链接 - 若移动时提示权限不足,可在命令前加
sudo,不过用户目录下的文件一般不需要 - 速度方面:用USB3.0以上接口的SSD,编译速度和内置盘几乎无差;老USB2.0的SSD会拖慢速度,尽量选高速款
我这么用了大半年,没出过任何问题,瞬间给Mac腾出了200多G空间,爽得不行!有问题随时问~




