Mac环境下执行sudo cordova run android报错：未找到JAVA_HOME环境变量

Hey there, let's break down what's going on here and fix this step by step!

问题根源 #

你遇到的核心问题有两个：

1. sudo的环境变量隔离：当你用sudo执行命令时，系统会重置环境变量，不会加载你用户目录下的~/.bash_profile或~/.zshrc配置，所以你之前配置的JAVA_HOME在sudo环境里根本读不到。
2. 找不到bash_profile的原因：Mac从Catalina版本开始默认用zsh作为默认shell，所以配置文件是~/.zshrc而不是~/.bash_profile；另外，这些配置文件是隐藏文件，默认在Finder里看不到。

分步解决方案 #

1. 先确认你的Java实际安装路径 #

先在终端执行这个命令，获取当前系统的Java路径：

/usr/libexec/java_home -v

它会输出类似这样的路径（根据你的Java版本不同会有差异）：

/Library/Java/JavaVirtualMachines/jdk1.8.0_301.jdk/Contents/Home

2. 正确配置用户级的JAVA_HOME #

情况A：用bash作为默认shell

• 先显示隐藏文件：打开Finder，按下Cmd + Shift + .（点号），就能看到隐藏文件了。
• 找到~/.bash_profile，如果没有就新建一个：

  touch ~/.bash_profile
  open ~/.bash_profile
  

• 在文件里添加以下内容：

  export JAVA_HOME=$(/usr/libexec/java_home)
  export PATH=$JAVA_HOME/bin:$PATH
  

• 保存后执行这个命令让配置生效：

  source ~/.bash_profile
  

情况B：用zsh作为默认shell（当前Mac默认）

• 打开zsh的配置文件：

  open ~/.zshrc
  

• 同样添加这两行内容：

  export JAVA_HOME=$(/usr/libexec/java_home)
  export PATH=$JAVA_HOME/bin:$PATH
  

• 保存后生效：

  source ~/.zshrc
  

3. 让sudo能读取JAVA_HOME #

因为sudo默认不继承用户的环境变量，有两种安全的解决方式：

方法1：让sudo保留指定环境变量（推荐）

• 执行sudo visudo打开sudo配置文件（这是编辑sudoers的安全方式，不要直接用vim编辑）。
• 在文件里找到Defaults env_reset这一行，在下面添加：

  Defaults        env_keep += "JAVA_HOME PATH"
  

• 保存退出：按下Esc键，输入:wq然后回车。
• 现在再执行sudo echo $JAVA_HOME，应该能看到正确的Java路径了。

方法2：临时传递环境变量到sudo命令

如果你不想修改sudo配置，可以在每次执行时手动传递：

sudo JAVA_HOME=$JAVA_HOME cordova run android

4. 验证并运行Cordova #

先执行echo $JAVA_HOME确认普通用户环境下路径正确，再执行sudo echo $JAVA_HOME确认sudo环境也能读到，之后再运行：

sudo cordova run android

应该就不会再提示找不到JAVA_HOME了。

额外注意事项 #

• 尽量不要用sudo运行Cordova：频繁用sudo会导致项目目录下的文件权限变成root，后续普通用户操作会报错。如果之前已经用sudo运行过导致权限问题，执行下面的命令修复：

  sudo chown -R $USER:$USER ~/.cordova
  sudo chown -R $USER:$USER 你的Cordova项目目录
  

• 确认Gradle和Node的环境变量也配置正确：同样可以在~/.bash_profile或~/.zshrc里添加它们的路径，确保普通用户和sudo环境都能读到。

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