GitHub Actions流水线中Ansible无法找到Windows主机Python解释器

问题根源 #

你当前的错误核心是：把控制节点（Linux自托管运行器）的Python路径/usr/bin/python3配置给了Windows主机，而Windows系统不存在Linux风格的路径，导致执行时提示找不到该程序。Ansible的interpreter_python参数如果全局设置，会作用于所有主机，Windows主机无法识别Linux路径。

具体解决思路 #

1. 针对Windows主机单独设置Python解释器路径

不要在全局defaults里配置interpreter_python，而是在inventory中给Windows主机单独指定其本地的Python路径：

inventory: |
  [all]
  ${{ steps.vmip.outputs.vmIp }} ansible_python_interpreter=C:\Python38\python.exe

• 替换C:\Python38\python.exe为你Windows主机上实际的Python安装路径（如果已将Python加入系统PATH，也可以直接写python.exe）。

2. 确保Windows主机已安装Python

如果Windows主机上还没装Python，需要先完成安装：

• 从Python官网下载Windows版本安装包，勾选Add Python to PATH选项。
• 安装后在Windows终端执行python --version验证是否能正常调用。

3. 调整GitHub Actions的Ansible配置

修改你的作业步骤，移除全局配置中的interpreter_python，改为在inventory或playbook中指定：

- name: Windows configuration via Ansible
  uses: dawidd6/action-ansible-playbook@v2
  with:
    playbook: ansible/windows/site.yml
    configuration: |
      [defaults]
      callbacks_enabled = ansible.posix.profile_tasks, stdout_callback = yaml
      collections_path = ./collections/ansible_collections/
    inventory: |
      [all]
      ${{ steps.vmip.outputs.vmIp }} ansible_python_interpreter=C:\Python38\python.exe
    vault_password: ${{secrets.VAULT_PASSWORD}}
    options: |
      -vvv 

4. 可选：使用auto_silent自动探测

如果不确定Windows主机的Python路径，可以尝试设置ansible_python_interpreter=auto_silent，让Ansible自动在Windows环境中探测有效Python解释器：

inventory: |
  [all]
  ${{ steps.vmip.outputs.vmIp }} ansible_python_interpreter=auto_silent

补充说明 #

• 控制节点（自托管运行器）的Python是给Ansible自身运行用的，和Windows主机上的Python是两个完全独立的环境，不要混淆配置。
• 若你的Playbook中使用了无需Python的Windows原生模块（如win_command、win_copy），部分场景下可以不需要Python，但多数Ansible Windows模块依赖目标主机上的Python环境。

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