如何解决Linux环境Azure Pipeline中git的fatal: $HOME not set错误？

错误原因 #

git config --system用于修改系统级Git配置（对应/etc/gitconfig文件），但Azure Pipeline的Linux代理执行任务时，运行环境可能未正确初始化$HOME环境变量。Git在处理系统级配置的内部流程中，部分逻辑仍依赖$HOME变量完成初始化或权限校验，变量缺失时就会触发该错误。

解决方法 #

方法1：改用仓库级Git配置（推荐） #

放弃系统级配置，使用--local参数设置当前仓库的Git邮箱，这个操作无需系统权限，也不依赖$HOME的系统级校验，完全适配CI/CD环境：

git config --local user.email "<email>"

方法2：手动设置$HOME后执行系统级配置 #

如果必须修改系统级配置，可在执行Git命令前手动指定$HOME变量，示例Azure-pipeline.yml片段：

steps:
  - script: |
      export HOME=/tmp
      git config --system user.email "<email>"
    displayName: Configure Git system-level email

注意：此方法需要代理拥有修改系统配置的权限（如sudo），若代理无对应权限，会触发权限错误，此时优先使用方法1。

方法3：检查代理运行上下文 #

在任务中添加环境变量打印步骤，确认$HOME是否存在：

echo $HOME

若输出为空，说明代理运行在无主进程上下文（如未初始化环境的root进程），需调整代理的启动方式，确保其在正常用户上下文下运行。

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