### 使用 GitHub Actions 打包 Python 文件 要使用 GitHub Actions 来打包 Python 文件为可分发格式，可以按照以下方式配置工作流文件 `.github/workflows/python-package.yml`。此文件定义了一个自动化流程，用于构建、测试以及生成 `sdist` 和 `bdist_wheel` 的分发包。 #### 创建 GitHub Actions 工作流文件 以下是完整的 YAML 配置示例： ```yaml name: Build and Package Python Project on: push: branches: - main # 或者其他分支 pull_request: branches: - main jobs: build-and-package: runs-on: ubuntu-latest steps: - name: Checkout repository uses: actions/checkout@v3 - name: Set up Python uses: actions/setup-python@v4 with: python-version: '3.9' # 可根据需求调整版本 - name: Install dependencies run: | python -m pip install --upgrade pip setuptools wheel twine - name: Build distribution packages run: | python setup.py sdist bdist_wheel - name: Upload artifacts uses: actions/upload-artifact@v3 with: name: python-dist path: dist/ ``` #### 解析配置细节 1. **触发条件**: 此工作流会在向 `main` 分支推送代码或创建拉取请求时启动[^4]。 2. **环境设置**: 使用 Ubuntu 运行器，并安装指定版本的 Python（此处为 3.9）。这一步还升级了必要的工具链，如 `setuptools`, `wheel`, 和 `twine`[^1]。 3. **构建命令**: 利用 `setup.py` 构建源码分布 (`sdist`) 和轮子分布 (`bdist_wheel`) 包[^1]。 4. **上传工件**: 将生成的 `dist/` 目录作为工件上传以便后续下载或部署[^4]。 如果希望进一步将这些包发布到 PyPI，则可以在最后增加一个步骤调用 Twine: ```yaml - name: Publish package to PyPI env: TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }} TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }} run: | twine upload dist/* ``` 注意：需要提前在仓库 Secrets 中存储用户名和密码以供安全访问。 #### 提交与验证 完成上述配置后提交更改至远程仓库即可激活该动作。每次更新都会自动执行所设定的任务序列[^5]。 --- ###