【Python｜GitHub Actions】GitHub自动化

手动构建上传

1. 安装构建和上传需要的安装包

pip install build twine

2. 构建包

python -m build

3. 上传包

twine upload dist/*

自动化构建上传（GitHub Actions）

1. 创建文件

.github/workflows/publish.yml

2. 设置 PyPI 密钥

  - 登录PyPI，生成一个API Token。

  - 在 GitHub 项目中，打开Settings → Secrets and variables → Actions → New repository secret。

    - 名称：PYPI_API_TOKEN

    - 值：PyPI 的 API Token（形如pypi-***）

3. 打标签触发部署

git tag v1.0.0

git push origin v1.0.0

4. 

---

Test PyPI

如果需要验证以下几种情况的话，可以先上传 Test PyPI。

1. pyproject.toml/setup.py配置无误；

2. 构建后的.tar.gz和.whl文件完整可用；

3. 上传不会因为权限、命名、文件缺失等错误失败；

4. twine 的账号、token 是否配置正确。

正式 PyPI 一旦上传，就不能覆盖版本，而 Test PyPI 可以反复试。

Reference:

https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/