Android build.gradle中如何获取等效%userprofile%路径配置buildDir

之前写法失效的原因 #

• 直接写%userprofile%属于Windows命令行的变量语法，Gradle运行在JVM上，不会自动解析这种Shell层面的变量占位符，只会把它当成普通字符串路径处理，必然无法生效。
• System.getenv('HOME')、$System.env.HOME返回null的核心原因是：HOME是Linux、macOS等类Unix系统的用户目录环境变量，Windows系统默认不存在这个环境变量，Windows下对应用户主目录的环境变量名是USERPROFILE，直接读HOME在Windows环境下自然拿到null。

推荐方案：使用JVM内置系统属性（全平台兼容，稳定性最高） #

不需要手动区分操作系统，JVM启动时会自动注入当前系统的用户主路径参数，直接读取user.home系统属性即可，这是最可靠的方式，不会出现环境变量缺失的问题：

// 示例：将buildDir配置为用户目录下的custom-build子目录
buildDir = "${System.properties['user.home']}/custom-build/${project.name}"

该写法在全平台下的映射逻辑：

• Windows：自动对应%userprofile%指向的C:\Users\你的用户名路径
• macOS：自动对应用户主目录/Users/你的用户名
• Linux：自动对应用户主目录/home/你的用户名
  配置后可以在build.gradle中加一行打印逻辑校验路径是否正确，执行任意Gradle任务时就会输出识别到的路径：

println "当前识别到的用户主目录：${System.properties['user.home']}"

备选方案：按系统读取对应环境变量 #

如果有特殊场景必须读取环境变量，可以通过变量名兼容不同系统，注意加非空兜底：

def userHome = System.getenv('USERPROFILE') ?: System.getenv('HOME')
// 极端环境下如果两个变量都为空，兜底用JVM的user.home
if (userHome == null) {
    userHome = System.properties['user.home']
}
buildDir = "${userHome}/your-custom-build-path"

注意：不推荐优先用这个方案，部分精简版系统、容器环境可能缺失对应环境变量，稳定性弱于直接读取JVM系统属性的方案。

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