GitHub Actions中$HOME环境变量是什么？为何容器内HOME为/github/home？

为什么GitHub Action容器内HOME变量值为/github/home #

这是GitHub Actions平台的默认预设行为，和本地Docker运行逻辑不同：GitHub Actions启动容器执行工作流时，会强制将运行环境的HOME变量覆盖为/github/home，这个路径是runner为容器内执行工作流的默认用户预留的主目录，用来统一存放跨步骤共享的用户缓存、临时配置，不会使用镜像中原先默认的/root主目录路径，和镜像本身的ENV配置无关。

是否需要在docker entrypoint中使用sudo #

不需要，使用sudo反而会加剧问题：

• sudo默认会重置绝大多数环境变量，就算手动配置保留规则，也很容易遗漏PATH、RUSTUP_HOME、CARGO_HOME这类Rust运行必需的变量，进一步放大「找不到Rust」的问题
• sudo执行会带来用户权限切换，后续构建产物、缓存文件的所有者会变成root，容易触发普通用户无权限读写的报错

你遇到的rust is not well installed !报错本质是当前执行环境找不到rustc/cargo二进制：Rust工具链装在/root目录下，而当前环境HOME指向/github/home，rustup默认按HOME路径查找工具链，最终触发报错。可以选以下任意一种方案修复：

• （最推荐）构建自定义镜像时全局安装Rust：不要把rustup、cargo装在/root的用户目录下，构建镜像时显式设置全局环境变量：

  ENV RUSTUP_HOME=/usr/local/rustup \
      CARGO_HOME=/usr/local/cargo \
      PATH=/usr/local/cargo/bin:$PATH
  

  安装Rust时直接装到上述全局路径，后续不管HOME变量怎么被覆盖，都能正常找到Rust工具链，适配GitHub Actions的运行逻辑。
• （快速修复，无需重构镜像）在工作流执行trunk构建的步骤前，手动指定Rust相关环境变量：

  - name: Build web app with Trunk
    run: |
      export RUSTUP_HOME=/root/.rustup
      export CARGO_HOME=/root/.cargo
      export PATH="$CARGO_HOME/bin:$PATH"
      trunk build --release
  

• （临时方案，不推荐长期用）执行构建前把/root下的Rust配置软链到当前HOME目录：

  ln -sf /root/.rustup $HOME/.rustup
  ln -sf /root/.cargo $HOME/.cargo
  

  这种方式如果后续步骤有写入缓存、修改配置的操作，容易触发权限冲突。

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