如何在 GitHub Actions 中搭建 Python 环境

发布时间：2025-11-20

点击量：

使用 actions/setup-python@v5 可轻松配置 Python 环境，指定 python-version 即可安装对应版本，结合 strategy.matrix 实现多版本测试，通过 actions/cache@v3 缓存 pip 依赖提升 CI 效率，并依次执行依赖安装、测试运行与代码检查等步骤。

如何在 github actions 中搭建 python 环境

在 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 来批量运行：

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 版本都会独立运行一次测试流程。

如何在IOS平台下搭建PhoneGap开发环境 WORD版

本文档主要讲述的是如何在IOS平台下搭建PhoneGap开发环境；希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看

0 查看详情如何在IOS平台下搭建PhoneGap开发环境 WORD版

缓存依赖以加快构建速度

为了提升 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 项目。不复杂但容易忽略的是缓存和多版本测试配置，合理使用能显著提升效率。

以上就是如何在 GitHub Actions 中搭建 Python 环境的详细内容，更多请关注其它相关文章！

上一篇：Python CSV 文件的写入方法

下一篇：python如何清空屏幕上的图画？