执行ionic build android命令报错：Android_Home路径不匹配问题

我之前也碰到过一模一样的问题——明明手动设置了ANDROID_HOME指向$HOME\Android\Sdk，但Ionic构建时却硬要去读usr\lib\android-sdk这个系统默认路径。别慌，咱们一步步排查解决：

• 先确认环境变量是否真的生效
  先打开终端执行对应命令，看看输出是不是你预期的路径：

  • Linux/macOS：输入echo $ANDROID_HOME
  • Windows：输入echo %ANDROID_HOME%
    如果输出不对，说明你的环境变量配置没生效：
    • Linux/macOS：把export ANDROID_HOME="$HOME/Android/Sdk"和export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools加到~/.bashrc、~/.zshrc或者~/.profile里，然后执行source ~/.zshrc（对应你当前用的shell）让配置立即生效。
    • Windows：右键「此电脑」→属性→高级系统设置→环境变量，在系统变量里新增ANDROID_HOME，值设为%USERPROFILE%\Android\Sdk，再把%ANDROID_HOME%\tools和%ANDROID_HOME%\platform-tools添加到Path变量中，最后重启终端。

• 强制让Cordova/Ionic使用你的自定义SDK路径
  有时候即使环境变量对了，Cordova还是会优先读系统默认路径，这时候可以手动指定：
  在项目根目录执行构建命令时直接附加SDK路径：

  ionic cordova build android -- --android-sdk="$HOME/Android/Sdk"
  

  或者给Cordova设置全局默认配置，一劳永逸：

  cordova config set android.sdk.path "$HOME/Android/Sdk"
  

• 同步Android Studio的SDK配置
  打开Android Studio，进入「File→Settings→Appearance & Behavior→System Settings→Android SDK」，确认SDK Location和你设置的$HOME/Android/Sdk一致。如果不一致，改成你的路径并点击Apply保存——Ionic有时候会读取Android Studio的配置，这里必须和环境变量保持统一。

• 重启所有相关工具
  环境变量修改后，旧的终端、IDE窗口不会自动加载新配置，所以一定要关闭所有打开的终端、VS Code（如果用它开发），重新打开后再执行构建命令。

如果还是有问题，试试执行ionic doctor check，Ionic会自动检测环境配置的问题，并给出具体的修复提示。

内容的提问来源于stack exchange，提问作者BF.Safouen