使用 actions/setup-python@v5 可轻松配置 Python 环境，指定 python-version 即可安装对应版本，结合 strategy.matrix 实现多版本测试，通过 actions/cache@v3 缓存 pip 依赖提升 CI 效率，并依次执行依赖安装、测试运行与代码检查等步骤。
在 GitHub Actions 中搭建 Python 环境非常简单，主要通过官方提供的 actions/setup-python 动作来实现。你只需要在工作流文件中指定 Python 版本，GitHub Actions 就会自动为你配置好运行环境。
使用 setup-python 安装指定 Python 版本
在你的工作流文件（如 .github/workflows/test.yml）中，使用 actions/setup-python@v5 来安装 Python：
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.11'
这会将 Python 3.11 安装到运行环境中，并将其设为默认版本。
支持多版本测试
如果你的项目需要在多个 Python 版本中测试，可以使用 strategy.matrix 来批量运行：
立即学习“Python免费学习笔记（深入）”；
jobs:
test:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: ['3.8', '3.9', '3.10', '3.11']
steps:
- uses: actions/checkout@v4
- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python-version }}
- name: Install dependencies
run: pip install -r requirements.txt
- name: Run tests
run: python -m pytest
这样每个 Python 版本都会独立运行一次测试流程。
缓存依赖以加快构建速度
为了提升 CI 效率，建议缓存 pip 安装的依赖包：
- name: Cache pip
uses: actions/cache@v3
with:
path: ~/.cache/pip
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
restore-keys: |
${{ runner.os }}-pip-
这段配置会根据 requirements.txt 的内容生成缓存键，避免重复下载已安装的包。
常用操作补充
搭建完 Python 环境后，通常还需要：
-
安装依赖：
pip install -r requirements.txt -
运行测试：
python -m unittest或pytest -
检查代码风格： 使用
flake8或ruff -
构建包：
python -m build（需安装build）
基本上就这些。只要正确使用 setup-python，再配合依赖安装和测试命令，就能在 GitHub Actions 上稳定运行 Python 项目。不复杂但容易忽略的是缓存和多版本测试配置，合理使用能显著提升效率。
