一、前置说明
- 先完全关闭 Android Studio,避免文件占用
- 假设配置:
- 原 SDK 路径:
C:\Users\当前用户名\AppData\Local\Android\Sdk - 目标路径:
D:\Android\Sdk - 同时迁移
.android、.gradle到D:\Android(进一步释放 C 盘)
- 原 SDK 路径:
- 脚本为 Windows BAT 批处理,右键「以管理员身份运行」
二、第一步:迁移文件脚本 MoveAndroidSDK.bat
新建文本文档,粘贴下方代码,后缀改为 .bat
bat
@echo off
chcp 65001
echo ==============================================
echo Android SDK & .android .gradle 迁移脚本
echo 请确保已关闭 Android Studio!
echo ==============================================
pause
:: 定义路径,根据自己需求修改这里!
set "USER_NAME=%username%"
set "OLD_SDK=C:\Users\%USER_NAME%\AppData\Local\Android\Sdk"
set "NEW_SDK=D:\Android\Sdk"
set "OLD_USER_DIR=C:\Users\%USER_NAME%"
set "NEW_USER_DIR=D:\Android"
:: 创建目标文件夹
echo.
echo 正在创建目标目录...
mkdir "%NEW_SDK%" 2>nul
mkdir "%NEW_USER_DIR%\.android" 2>nul
mkdir "%NEW_USER_DIR%\.gradle" 2>nul
:: 复制完整SDK(包含隐藏文件、子目录)
echo.
echo 正在复制 SDK 文件,请耐心等待...
xcopy "%OLD_SDK%\*" "%NEW_SDK%\" /E /H /C /Y /K
:: 复制 .android 和 .gradle
echo.
echo 正在复制 .android 配置...
xcopy "%OLD_USER_DIR%\.android\*" "%NEW_USER_DIR%\.android\" /E /H /C /Y /K
echo.
echo 正在复制 .gradle 缓存...
xcopy "%OLD_USER_DIR%\.gradle\*" "%NEW_USER_DIR%\.gradle\" /E /H /C /Y /K
echo.
echo ==============================================
echo 文件复制完成!
echo 接下来请执行第二步:修改Studio虚拟机参数
echo ==============================================
pause
使用修改:
如果想换盘符 / 文件夹,只改脚本里这两行即可:
plaintext
set "NEW_SDK=D:\Android\Sdk"
set "NEW_USER_DIR=D:\Android"
三、第二步:修改 Android Studio vmoptions(关键)
作用:让 Studio 识别新路径、重定向 .android/.gradle
- 找到 Android Studio 安装目录,进入
bin文件夹- 64 位系统编辑:
studio64.exe.vmoptions - 32 位系统编辑:
studio.exe.vmoptions
- 64 位系统编辑:
- 在文件末尾追加一行:
plaintext
-Dandroid.user.home=D:\Android
路径和上面脚本里
NEW_USER_DIR保持一致
四、第三步:修改项目内 local.properties(逐个项目处理)
打开每个 Android 项目根目录下的 local.properties把原有 sdk.dir 行替换为:
properties
sdk.dir=D:/Android/Sdk
五、第四步:Studio 内确认 SDK 路径
- 重新打开 Android Studio
File → Settings → Appearance & Behavior → System Settings → Android SDK- 检查
Android SDK Location是否为D:\Android\Sdk - 点击
Apply → OK,同步项目即可正常编译
六、收尾(可选)
全部验证运行正常后,再手动删除 C 盘旧目录:
C:\Users\用户名\AppData\Local\Android\SdkC:\Users\用户名\.androidC:\Users\用户名\.gradle
导出文档
这里把完整操作文档 + 脚本代码 整理成可直接复制保存的版本,你新建 .txt 文档粘贴、保存即可,也可另存为 .md 格式方便查看。
Android Studio SDK 迁移至其他磁盘 完整操作文档
文档说明
适用系统:Windows功能:将默认 C 盘的 Android SDK、.android、.gradle 完整迁移至其他磁盘,附带一键复制批处理脚本,无需重新下载文件。前置要求:操作前务必完全关闭 Android Studio,防止文件被占用。
一、整体规划路径(默认配置,可自行修改)
- 原 SDK 路径
C:\Users\你的用户名\AppData\Local\Android\Sdk - 目标路径(示例 D 盘)
- SDK 新路径:
D:\Android\Sdk - .android/.gradle 统一存放:
D:\Android
提示:
AppData为系统隐藏文件夹,正常无需手动打开,脚本会自动识别。
二、第一步:使用批处理脚本迁移文件
1. 创建批处理文件
- 桌面右键 → 新建 → 文本文档
- 打开文档,复制下方全部代码粘贴进去
- 点击「文件 - 另存为」,文件名 填写:
MoveAndroidSDK.bat - 保存类型选择:所有文件,编码选择:ANSI/UTF-8,保存到桌面
2. 批处理代码(MoveAndroidSDK.bat)
bat
@echo off
chcp 65001
echo ==============================================
echo Android SDK & .android .gradle 迁移脚本
echo 请确保已关闭 Android Studio!
echo ==============================================
pause
:: ========== 可修改区域 开始 ==========
:: 如需更换盘符/文件夹,仅修改下方两行路径即可
set "NEW_SDK=D:\Android\Sdk"
set "NEW_USER_DIR=D:\Android"
:: ========== 可修改区域 结束 ==========
set "USER_NAME=%username%"
set "OLD_SDK=C:\Users\%USER_NAME%\AppData\Local\Android\Sdk"
set "OLD_USER_DIR=C:\Users\%USER_NAME%"
:: 创建目标文件夹
echo.
echo 正在创建目标目录...
mkdir "%NEW_SDK%" 2>nul
mkdir "%NEW_USER_DIR%\.android" 2>nul
mkdir "%NEW_USER_DIR%\.gradle" 2>nul
:: 复制完整SDK(包含隐藏文件、子目录)
echo.
echo 正在复制 SDK 文件,请耐心等待...
xcopy "%OLD_SDK%\*" "%NEW_SDK%\" /E /H /C /Y /K
:: 复制 .android 和 .gradle 配置与缓存
echo.
echo 正在复制 .android 配置文件...
xcopy "%OLD_USER_DIR%\.android\*" "%NEW_USER_DIR%\.android\" /E /H /C /Y /K
echo.
echo 正在复制 .gradle 缓存文件...
xcopy "%OLD_USER_DIR%\.gradle\*" "%NEW_USER_DIR%\.gradle\" /E /H /C /Y /K
echo.
echo ==============================================
echo 文件复制完成!
echo 请继续执行后续配置步骤
echo ==============================================
pause
3. 运行脚本
- 右键
MoveAndroidSDK.bat→ 以管理员身份运行 - 按回车键开始执行,文件体积大时请耐心等待复制完成
- 出现「文件复制完成」即代表这一步结束,关闭窗口
三、第二步:修改 Studio 虚拟机配置(重定向目录)
该步骤作用:让 Android Studio 识别新的 .android、.gradle 路径
- 找到你的 Android Studio 安装目录,进入
bin文件夹 - 根据系统位数选择文件:
- 64 位系统:编辑
studio64.exe.vmoptions - 32 位系统:编辑
studio.exe.vmoptions
- 64 位系统:编辑
- 用记事本打开文件,在文档最后一行追加以下内容:
plaintext
-Dandroid.user.home=D:\Android
路径必须和脚本内
NEW_USER_DIR保持一致,修改过路径则同步替换。
- 保存文件并关闭。
四、第三步:修改项目配置文件(解决编译报错)
打开每一个 Android 项目,找到项目根目录下的 local.properties 文件修改其中 sdk.dir 配置,示例:
properties
# 原配置(C盘路径,全部替换)
# sdk.dir=C\:\\Users\\用户名\\AppData\\Local\\Android\\Sdk
# 新配置(直接使用此行)
sdk.dir=D:/Android/Sdk
修改完成后保存文件。
五、第四步:Android Studio 内确认 SDK 路径
- 重新启动 Android Studio
- 顶部菜单栏:
File→Settings(快捷键 Ctrl+Alt+S) - 依次展开:
Appearance & Behavior→System Settings→Android SDK - 查看
Android SDK Location,确认路径为D:\Android\Sdk - 点击
Apply→OK,等待项目同步完成。
六、验证迁移是否成功
- 正常同步、编译项目,无「SDK 未找到」报错
- 安卓模拟器可正常启动运行
- 新下载 SDK 组件、gradle 缓存均自动保存至 D 盘目标目录
七、收尾清理(可选,确认无误后操作)
所有功能测试正常后,可手动删除 C 盘旧目录释放空间:
C:\Users\你的用户名\AppData\Local\Android\SdkC:\Users\你的用户名\.androidC:\Users\你的用户名\.gradle