GitHub Workflow安装Python 3.8.2失败：版本未找到问题排查

可能的原因及解决办法 #

1. 升级actions/setup-python版本 #

v3版本的setup-python存在旧版本Python查找的兼容性问题，建议升级到最新稳定版（如v4或更高），新版本修复了版本匹配相关bug，能更准确地从版本清单中定位对应版本。

修改Workflow中的对应步骤：

- name: Set up Python ${{ matrix.python-version }}
  uses: actions/setup-python@v4  # 替换为最新稳定版本
  with:
    python-version: ${{ matrix.python-version }}

2. 指定具体的Ubuntu runner版本 #

ubuntu-latest会自动切换到最新Ubuntu发行版，部分旧版Python在新系统的包索引中可能存在适配问题。可尝试指定更稳定的旧版本Ubuntu，比如ubuntu-20.04：

修改Workflow中的runs-on字段：

runs-on: ubuntu-20.04

3. 验证版本清单的可访问性 #

偶尔会出现CDN缓存或版本同步延迟的情况，可在Workflow中添加步骤，直接在runner环境中拉取并检查版本清单：

- name: Check Python version manifest
  run: |
    curl -s https://raw.githubusercontent.com/actions/python-versions/main/versions-manifest.json | grep "3.8.2"

补充说明 #

如果必须严格使用Python 3.8.2，优先尝试升级setup-python版本，这是解决此类版本找不到问题最有效的方式；若升级后仍有问题，再尝试更换runner系统版本。

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