如何修改Android Studio存储及执行路径以释放内置SSD空间

核心迁移对象定位 #

Android Studio默认在SSD上存储的高占用目录主要包含以下几类，是优先迁移的目标：

• 全局配置、插件、系统缓存目录
• Android SDK 程序与镜像文件目录
• 全局Gradle构建缓存目录（单项目构建产物单文件体积小，可按需定期清理）
• 安卓虚拟设备（AVD）镜像目录

分步骤迁移操作 #

1. 全局配置/缓存/插件目录迁移 #

这部分是占空间比较零散的目录，直接用官方支持的启动参数覆盖路径，比软链接稳定性更高：

1. 完全退出所有正在运行的Android Studio、Gradle后台进程
2. 定位到Android Studio的可执行程序位置：
   • Windows：安装目录下的 studio64.exe
   • macOS/Linux：安装目录 bin 文件夹下的 studio.sh
3. 追加启动参数自定义存储路径：
   • Windows：为 studio64.exe 创建桌面快捷方式，在快捷方式的「目标」输入框原有内容末尾，空格后追加参数：

     -Didea.config.path=X:\AndroidStudioData\config -Didea.system.path=X:\AndroidStudioData\system -Didea.plugins.path=X:\AndroidStudioData\plugins
     

     （把X:\AndroidStudioData替换为你大容量存储上的实际目标路径）
   • macOS/Linux：用文本编辑器打开 studio.sh 启动脚本，在脚本开头追加三行环境变量定义：

     export IDEA_CONFIG_PATH="/Volumes/ExtDisk/AndroidStudioData/config"
     export IDEA_SYSTEM_PATH="/Volumes/ExtDisk/AndroidStudioData/system"
     export IDEA_PLUGINS_PATH="/Volumes/ExtDisk/AndroidStudioData/plugins"
     

4. 把原SSD默认路径下的config、system、plugins三个目录的全部文件，完整剪切到你新设置的对应路径下，再通过修改后的快捷方式/脚本启动Android Studio，确认原有项目列表、插件、配置全部正常加载即完成迁移。

2. Android SDK 目录迁移 #

SDK目录通常会占用10GB-30GB空间，迁移步骤无额外依赖：

1. 关闭Android Studio后，将SSD上默认的SDK目录（Windows默认在 C:\Users\[你的用户名]\AppData\Local\Android\Sdk，macOS/Linux默认在 ~/Android/Sdk）完整剪切到目标存储路径下，比如 X:\Dev\Android\Sdk
2. 重新启动Android Studio，进入设置页的 Appearance & Behavior > System Settings > Android SDK 面板
3. 修改 Android SDK Location 选项为新的SDK路径，点击应用等待SDK索引重建完成
4. 配置系统全局环境变量，将 ANDROID_HOME 变量值替换为新的SDK路径，保证命令行构建工具可正常定位SDK。

3. 全局Gradle缓存目录迁移 #

Gradle全局缓存通常会积累几十GB的依赖包、构建产物，是最容易被忽略的空间占用源：

1. 关闭所有构建进程后，找到SSD上默认的全局Gradle缓存目录（Windows默认在 C:\Users\[你的用户名]\.gradle，macOS/Linux默认在 ~/.gradle）
2. 把这个目录完整剪切到目标存储路径下，比如 X:\DevCache\gradle_home
3. 进入Android Studio设置页的 Build, Execution, Deployment > Build Tools > Gradle 面板
4. 修改 Gradle user home 选项为刚才迁移的新目录路径，保存设置即可。

4. 安卓虚拟设备（AVD）镜像目录迁移 #

单份AVD镜像体积通常在5GB-15GB，长期积累会占用大量SSD空间：

1. 关闭所有正在运行的模拟器进程，将默认AVD目录（Windows默认在 C:\Users\[你的用户名]\.android\avd，macOS/Linux默认在 ~/.android/avd）完整剪切到目标存储路径下，比如 X:\Emulators\android_avd
2. 配置系统全局环境变量，新增变量 ANDROID_AVD_HOME，变量值设为刚才迁移的新AVD目录路径
3. 重启Android Studio，打开设备管理器面板，确认所有已创建的模拟器可正常识别、启动即完成迁移。

实操注意事项 #

• 所有目录迁移必须做完整文件剪切，不要只创建快捷方式，避免出现文件校验失败、索引异常的问题
• 自定义的存储路径不要包含中文、特殊空格字符，否则会引发构建脚本解析错误
• 迁移完成后首次启动Android Studio时，IDE会重新做全量文件索引，过程持续数分钟属于正常现象，无需强制退出
• 单项目下的 .gradle、build 目录可直接在非工作时间删除，后续打开项目时会自动重建，不需要手动迁移

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