Windows自托管Runner中GitHub Actions环境变量写入失效及路径运算咨询

一、环境变量写入失败的修复方案 #

你当前的问题出在PowerShell下写入$GITHUB_ENV的语法和编码问题上，修正后的步骤代码如下：

- name: pip install xmlcli
  env:
    MYTOOLS: ${{ runner.tool_cache }}\mytools
  run: |
    echo "${{ runner.tool_cache }}"
    $env:MYTOOLS
    pip install --no-cache-dir --upgrade mytools.xmlcli --target=$env:MYTOOLS -i ${{ secrets.PIP_INDEX_URL }}
    # 修正后的环境变量写入方式
    Write-Output "XMLCLI=$env:MYTOOLS\mytools\xmlcli" | Out-File -FilePath $env:GITHUB_ENV -Append -Encoding utf8

- name: test xmlcli
  run: echo "${{ env.XMLCLI }}"

关键修正点： #

1. 移除多余反引号：原代码末尾的反引号是无效语法，会导致命令执行中断，无法完成环境变量写入。
2. 替换输出方式：PowerShell中直接用>>追加文件默认使用ANSI编码，而GitHub Actions要求GITHUB_ENV文件为UTF-8编码，使用Out-File -Encoding utf8可避免编码乱码导致的变量读取失败。
3. 修正变量引用格式：{$env:MYTOOLS}是错误的PowerShell变量写法，直接使用$env:MYTOOLS即可正确解析环境变量。

二、GitHub Actions路径运算相关资源 #

官方文档核心内容： #

• 预定义路径环境变量：GitHub Actions提供了一系列预定义变量用于路径操作，比如runner.tool_cache（工具缓存目录）、GITHUB_WORKSPACE（工作流执行目录）、GITHUB_TEMP（临时文件目录）等，这些变量可直接在工作流中通过${{ 变量名 }}引用。
• 跨平台路径处理：若需要兼容多操作系统，可使用joinPath函数自动适配路径分隔符，例如${{ joinPath(runner.tool_cache, 'mytools') }}；也可使用format函数自定义路径格式，如${{ format('{0}\mytools', runner.tool_cache) }}（Windows）或${{ format('{0}/mytools', runner.tool_cache) }}（Linux/macOS）。
• shell路径语法差异：不同shell的路径变量语法不同，Windows PowerShell使用$env:变量名，CMD使用%变量名%，Linux/macOS Bash使用$变量名，需根据runner默认shell选择对应语法。

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