Python如何将自建项目打包上传至PyPI_使用setuptools与twine-Python教程-PHP中文网

推荐使用pyproject.toml（pep 517/518），setup.py仅兼容；必填字段包括name、version、description、readme、requires-python；必须用pypi api token而非密码，上传前需执行python -m build、twine check、本地pip安装三步验证。

python如何将自建项目打包上传至pypi_使用setuptools与twine

能传上去，但大概率第一次会失败——不是代码问题，而是 setup.py 或 pyproject.toml 里少写了关键元数据，或者认证方式没走对 twine 流程。

setup.py 和 pyproject.toml 到底该用哪个？

Python 官方已明确推荐 pyproject.toml（PEP 517/518），setup.py 处于“兼容但不鼓励新增使用”状态。新项目直接写 pyproject.toml，避免后续迁移成本。

如果你用 setuptools>=61.0，pyproject.toml 可完全替代 setup.py，无需两者共存
setup.py 若仍存在，会被忽略（除非显式加 [build-system] 指向它）
常见错误：只改了 setup.py 版本号，却忘了同步 pyproject.toml 里的 version 字段，导致上传的包版本和本地不一致

pyproject.toml 必须填哪些字段才能过 PyPI 校验？

PyPI 在上传时会严格校验元数据，缺一不可。最常被漏掉的是 description 和 readme，哪怕内容只写一行也会通过。

python-parallelization

将顺序 Python 代码转换为并行/并发实现，用于在需要并行化 Python 代码、提升性能时使用。

下载

name：必须全小写、仅含字母数字和短横线（my-awesome-lib ✅，MyAwesomeLib ❌）
version：建议用 dynamic 方式从 __version__ 读取，避免手动维护两处
description：不能为空，哪怕填 "A small utility"
readme：必须存在且路径正确（如 "README.md"），否则 twine check 直接报错 Invalid value for 'long_description': No content type specified.
requires-python：例如 >=3.8，不写会导致上传成功但安装时提示 Package requires Python >=3.x but running on 3.y

twine upload 总是 403 或 “invalid or non-existent authentication information”

这不是密码错了，而是你没用 PyPI 的 API token，还在试图传账号密码——PyPI 自 2023 年起已禁用密码直传。

去 https://www.php.cn/link/0e1ceaca3e404ed57c3d9d6eaa2928a3 创建一个 Scoped token（限制到具体项目名更安全）
上传命令必须用 twine upload --repository testpypi（测试）或 --repository pypi（正式），不能省略 --repository
凭证要存在 ~/.pypirc 或用环境变量 TWINE_USERNAME=__token__ + TWINE_PASSWORD=your-token-here
常见坑：twine upload dist/* 如果 dist 目录里混着旧包（比如不同版本或 .tar.gz / .whl 都有），可能因重复上传失败，建议每次先 rm -rf dist/

上传前必须跑的三步本地检查

跳过这三步，90% 的上传失败都发生在这儿，而且错误信息藏得深。

python -m build：生成 dist/ 下的 .whl 和 .tar.gz，失败说明 pyproject.toml 语法或依赖声明有硬伤
twine check dist/*：验证包描述是否可解析、README 格式是否合法，报 InvalidDistribution 多半是 readme 路径错或没指定 content-type
pip install --find-links dist/ --no-index your-package-name：在干净虚拟环境中装一下，确认 import 和入口点是否真能工作——很多包上传后 install 成功但 import 报 ModuleNotFoundError，是因为 packages 没自动发现子模块

最麻烦的其实是包结构本身：比如你的模块在 src/mylib/ 下，但 pyproject.toml 没配 packages = [{include = "mylib", from = "src"}]，那么生成的 wheel 里就压根没代码。这种问题不会在 twine check 里暴露，只能靠最后那步本地安装验证。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！