Android Studio中Gradle命令的PATH配置及npm找不到问题排查

一、先确认Android Studio当前使用的PATH #

在项目的Gradle脚本中添加以下任务，打印当前环境的PATH，对比终端PATH定位差异：

task printPath {
    doLast {
        println "Current PATH: " + System.getenv("PATH")
    }
}

在Gradle面板找到printPath任务运行，再在终端执行echo $PATH，两者对比即可看出PATH差异。

二、设置Android Studio的PATH方法 #

方法1：IDE全局配置PATH #

1. 打开Android Studio，进入Preferences（Mac路径：Android Studio > Settings）
2. 搜索Terminal，在Environment variables区域点击+，添加变量：
   • 变量名：PATH
   • 变量值：复制终端echo $PATH输出的完整内容
3. 重启Android Studio后重新运行构建脚本

方法2：Gradle任务中直接指定npm绝对路径 #

先在终端执行which npm获取npm的绝对路径（例如/usr/local/bin/npm），然后修改执行npm的Gradle任务：

task runNpmScript {
    doLast {
        exec {
            commandLine "/usr/local/bin/npm", "run", "你的脚本名称"
        }
    }
}

方法3：通过启动脚本配置环境变量 #

1. 找到Mac上Android Studio的启动脚本路径：/Applications/Android Studio.app/Contents/bin/studio.vmoptions
2. 在文件末尾添加一行：

   -Denv.PATH=你的完整PATH内容
   

3. 保存后重启Android Studio

三、额外排查点 #

• 若使用nvm管理Node.js，需将nvm对应的Node版本路径（例如~/.nvm/versions/node/v16.15.0/bin）添加到PATH中
• 检查系统近期是否有更新导致PATH重置，或是否用不同用户权限启动Android Studio

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