如何让自托管GitHub Runner调用系统环境变量中的Python？

问题根源 #

GitHub Runner在Mac上运行时使用的是非交互式、非登录shell，不会自动加载~/.zshrc这类用户配置文件，所以你之前在.zshrc里设置的PATH不会生效；另外你之前在.env里的配置写法错误，没有正确修改PATH变量。

可行解决方案 #

方案1：修改Runner服务的全局环境变量（推荐）

这是全局生效的方案，所有工作流都会自动使用该配置：

1. 进入你的GitHub Runner安装目录，停止Runner服务：

   ./svc stop
   

2. 编辑目录下的.env文件，添加正确的PATH配置（先在终端运行brew --prefix python获取实际路径，替换下面的路径）：

   PATH="/opt/homebrew/opt/python/libexec/bin:$PATH"
   

   注：Intel芯片Mac的路径通常是/usr/local/opt/python/libexec/bin，M系列芯片是/opt/homebrew/...

3. 重启Runner服务：

   ./svc start
   

方案2：在工作流脚本中手动加载配置

如果不想修改全局配置，可以在每个需要用Python的工作流步骤中手动添加路径：

steps:
  - name: 验证Python可用性
    run: |
      # 直接添加Homebrew Python的路径到当前shell的PATH
      export PATH="$(brew --prefix python)/libexec/bin:$PATH"
      python --version

或者直接加载你的.zshrc配置：

steps:
  - name: 验证Python可用性
    run: |
      source ~/.zshrc
      python --version

方案3：调整Runner的默认Shell

如果你的Runner默认使用bash而不是zsh，.zshrc的配置自然不会生效：

1. 先在工作流中确认当前Shell：

   steps:
     - name: 查看当前Shell
       run: echo $SHELL
   

2. 如果输出是/bin/bash，可以修改Runner的.env文件添加：

   SHELL=/bin/zsh
   

3. 重启Runner服务，之后Runner会用zsh执行脚本，若需要让登录shell加载配置，可把PATH配置放到~/.zprofile里（zsh登录shell会优先加载该文件）

额外注意事项 #

• 不要用actions/setup-python在自托管Runner上重复安装Python，容易引发路径冲突和卡住问题，直接用已安装的版本即可。
• 确认Homebrew安装的Python路径正确，在交互式终端运行which python，应输出/opt/homebrew/opt/python/libexec/bin/python（或对应Intel路径），说明你的.zshrc配置本身是正确的，只是Runner没加载到。

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