不能。截至2024年10月,GitHub Actions官方setup-python动作仅支持至Python 3.12.x,未支持3.13;需用pyenv手动安装预发布版(如3.13.0rc1),并注意pip升级、构建工具兼容性及避免setup-python覆盖。

GitHub Actions 能否直接使用 Python 3.13?
不能。截至 2024 年 10 月,GitHub Actions 官方 setup-python 动作尚未支持 Python 3.13(它只到 3.12.x)。尝试写 python-version: '3.13' 会报错 Version 3.13 with arch x64 not found。
用 pyenv + setup-python 安装 Python 3.13 预发布版
Python 3.13 目前处于预发布阶段(如 3.13.0rc1),需手动安装。推荐组合:先用 actions/setup-python@v4 安装一个基础版本(比如 3.12),再用 pyenv 拉取并编译 3.13 的源码或预编译二进制。
- GitHub Actions 默认 Ubuntu runner 已预装
pyenv,无需额外安装 - 用
pyenv install --list | grep 3.13查看可用版本(通常含3.13.0rc1、3.13.0b3等) - 执行
pyenv install 3.13.0rc1 && pyenv global 3.13.0rc1后,python --version即可验证 - 注意:源码编译耗时较长(约 3–5 分钟),建议加
timeout-minutes: 10防超时
完整 workflow 示例(含缓存与兼容性检查)
以下片段可直接嵌入 .github/workflows/test.yml:
- name: Set up Python 3.13 (rc)
run: |
pyenv install 3.13.0rc1
pyenv global 3.13.0rc1
python -m pip install --upgrade pip
<pre class="brush:php;toolbar:false;">- name: Install dependencies
run: python -m pip install -e .[test]
- name: Run tests
run: python -m pytest tests/- 不要跳过
pip install --upgrade pip—— Python 新版本常附带新版 pip,旧 pip 可能无法解析 3.13 的 wheel 标签 - 若项目用
pyproject.toml,确保构建后端(如build或setuptools)已更新到支持 3.13 的版本(例如setuptools>=69.0.0) - 避免在
setup-python步骤中指定python-version,否则会覆盖 pyenv 设置;或干脆省略该步骤
为什么不用 docker 或自建 runner?
没必要。Docker 镜像(如 python:3.13-rc)目前极不稳定,且 GitHub 不允许在托管 runner 上挂载特权容器;自建 runner 维护成本高,对抢鲜测试而言过度设计。
pyenv 方案最轻量、最贴近真实开发者本地环境,也最容易发现兼容性问题——比如某 C 扩展未适配新 C API,或 typing 模块行为变更导致类型检查失败。这些细节,恰恰是抢鲜测试最该捕获的。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











