You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows10 Linux子系统运行ionic cordova构建Android时ANDROID_HOME报错

解决WSL中构建Ionic Android包时的ANDROID_HOME/PATH错误

嘿,我懂你遇到的麻烦了!因为你是在Windows的Linux子系统(WSL)里操作,Windows的系统变量是不会自动同步到WSL环境中的,这就是为啥你在Windows里配了SDK路径还是报错。别慌,按照下面的步骤来就能搞定:

步骤1:确认Android SDK的WSL路径

首先找到你Windows里Android SDK的实际路径,默认一般是:
C:\Users\<你的用户名>\AppData\Local\Android\Sdk

把它转换成WSL能识别的路径——把盘符改成/mnt/c/,反斜杠换成正斜杠就行,比如:
/mnt/c/Users/John/AppData/Local/Android/Sdk(记得把John换成你的实际用户名)

步骤2:在WSL中配置环境变量

WSL有自己独立的环境变量配置,我们需要手动把Android SDK路径加进去:

  • 打开WSL终端,编辑你的shell配置文件。如果用默认bash,执行:
    nano ~/.bashrc
    
    如果是zsh,就执行:
    nano ~/.zshrc
    
  • 在文件末尾添加以下两行(替换成你自己的SDK路径):
    export ANDROID_HOME=/mnt/c/Users/<你的用户名>/AppData/Local/Android/Sdk
    export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
    
  • 保存并退出nano:按下Ctrl+O,回车确认保存,再按Ctrl+X退出。
  • 让配置立即生效,执行:
    source ~/.bashrc
    # 如果是zsh就执行 source ~/.zshrc
    

步骤3:验证配置是否生效

在WSL终端里执行以下命令,检查配置是否正确:

  • 查看ANDROID_HOME是否设置成功:
    echo $ANDROID_HOME
    
    应该输出你刚才配置的SDK路径。
  • 检查adb命令是否可用:
    adb --version
    
    如果能正常显示版本信息,说明PATH配置没问题。

步骤4:重新构建项目

现在回到你的Ionic项目目录,重新执行构建命令:

ionic cordova build --release android

这次应该就能正常构建了!

内容的提问来源于stack exchange,提问作者Mike K.

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.22 09:29:01