个人开源或内部工具包最怕:第一次 twine upload 直接打到正式 PyPI,元数据写错或版本号占坑。
Python Packaging User Guide《Using TestPyPI》说明:TestPyPI 是与正式索引分离的实例,托管在 test.pypi.org,用于练习分发工具与流程而不影响真实索引。因其独立数据库,需到 test.pypi.org 单独注册账号;文档注明数据库可能被定期 prune,用户账号被删并不少见。上传可用 twine,并指定 `--repository testpypi`,例如 `twine upload --repository testpypi dist/*`;成功后可打开 `https://test.pypi.org/project/<项目名>` 确认(可能延迟一两分钟才出现)。安装可用 pip 的 `--index-url https://test.pypi.org/simple/`;若包还有依赖需从正式 PyPI 拉,再加 `--extra-index-url https://pypi.org/simple/`。为减少反复输入凭据,可在 `$HOME/.pypirc` 配置 `[testpypi]`,用户名 `__token__`、密码为 TestPyPI API Token。本场景据此输出试发布/试装清单。禁止声称「已上传成功」或代存 token。