Ionic构建报错：ANDROID_SDK_ROOT与ANDROID_HOME未定义

核心问题 #

报错提示ANDROID_SDK_ROOT=undefined和ANDROID_HOME=undefined，说明系统环境变量未正确配置——即便更换了SDK版本，Cordova/Ionic依然无法定位到SDK路径。

解决方案步骤 #

1. 确认Android SDK实际路径

   • Windows：通常在C:\Users\<你的用户名>\AppData\Local\Android\Sdk（需开启显示隐藏项目）
   • Mac/Linux：通常在~/Library/Android/sdk（Mac）或/usr/local/android-sdk（Linux）

2. 配置环境变量

   • Windows系统：

     • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
     • 在「系统变量」区域点击「新建」：
       • 变量名：ANDROID_SDK_ROOT
       • 变量值：填写你找到的SDK完整路径
     • 找到「系统变量」里的Path，点击「编辑」，添加以下条目：
       • %ANDROID_SDK_ROOT%\platform-tools
       • %ANDROID_SDK_ROOT%\tools
       • %ANDROID_SDK_ROOT%\tools\bin
     • 点击「确定」保存所有设置

   • Mac/Linux系统：

     • 打开终端，根据使用的shell编辑配置文件：
       • Bash用户：nano ~/.bashrc
       • Zsh用户：nano ~/.zshrc
     • 在文件末尾添加以下内容（替换为你的SDK路径）：

       export ANDROID_SDK_ROOT=/Users/你的用户名/Library/Android/sdk
       export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools
       export PATH=$PATH:$ANDROID_SDK_ROOT/tools
       export PATH=$PATH:$ANDROID_SDK_ROOT/tools/bin
       

     • 按Ctrl+O保存，Ctrl+X退出，然后执行source ~/.bashrc或source ~/.zshrc使配置生效

3. 验证配置是否生效

   • 打开新的终端/命令提示符（旧会话不会加载新变量），执行：
     • Windows：echo %ANDROID_SDK_ROOT%，确认输出正确路径
     • Mac/Linux：echo $ANDROID_SDK_ROOT，确认输出正确路径
   • 执行adb version，如果能正常显示adb版本信息，说明路径配置正确

4. 额外检查项

   • 重启你的IDE（如VS Code）和所有终端窗口，确保新环境变量被加载
   • 打开Android Studio的SDK Manager，确认已安装Android 30的SDK Platform和对应版本的Build Tools
   • 避免SDK路径包含空格或特殊字符，否则可能导致识别失败

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