Flutter环境搭建：如何将Android SDK从一台设备迁移到另一台

步骤1：导出本机Android SDK包 #

• 先定位本机Android SDK路径：
  • Windows默认路径：C:\Users\<你的用户名>\AppData\Local\Android\Sdk
  • Mac默认路径：~/Library/Android/sdk
  • Linux默认路径：~/Android/Sdk
• 完整拷贝整个Sdk目录到移动存储设备，不要拆分目录，避免缺漏文件

步骤2：部署到目标设备 #

将拷贝的Sdk目录放到目标设备的自定义路径，路径不要带中文、空格或特殊字符，记录下完整的绝对路径备用。

步骤3：配置系统环境变量 #

Windows系统 #

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在系统变量区新建ANDROID_HOME变量，变量值填写刚才记录的SDK完整路径
• 编辑系统变量中的Path，新增三个条目：

  %ANDROID_HOME%\tools
  %ANDROID_HOME%\tools\bin
  %ANDROID_HOME%\platform-tools
  

• 保存所有设置后重启终端生效

Mac/Linux系统 #

• 打开终端编辑配置文件：zsh终端执行open ~/.zshrc，bash终端执行open ~/.bash_profile
• 在文件末尾添加以下内容：

  export ANDROID_HOME=替换为你的SDK完整绝对路径
  export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin:$ANDROID_HOME/platform-tools
  

• 保存文件后执行source ~/.zshrc（或对应bash的配置文件）使配置立即生效

步骤4：关联Flutter配置 #

终端执行命令，将SDK路径绑定到Flutter配置：

flutter config --android-sdk 替换为你的SDK完整绝对路径

步骤5：验证生效 #

1. 先执行sdkmanager --version，正常输出版本号说明环境变量配置成功
2. 执行flutter doctor --android-licenses，所有许可提示都输入y同意
3. 最后执行flutter doctor，检查Android SDK缺失的报错是否消失

注意事项 #

• 仅同系统的SDK包可以互相迁移，Windows系统导出的SDK仅能在Windows设备使用，Mac/Linux同理，跨系统迁移会出现兼容问题
• 如果目标设备已安装Android Studio，可直接打开设置→Appearance & Behavior→System Settings→Android SDK，在SDK Location处选择你拷贝的SDK目录，无需手动配置环境变量

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