如何使用Poetry将Python包发布到test.pypi.org测试站点

步骤1：配置TestPyPI仓库源 #

在Poetry中添加TestPyPI作为备用发布源，执行命令：
poetry config repositories.testpypi https://test.pypi.org/legacy/
其中testpypi是你给该源自定义的别名，后续发布操作可直接引用。

步骤2：构建安装包 #

执行构建命令生成标准发布格式的安装包：
poetry build
构建完成的wheel、sdist格式产物会存放在项目根目录的dist文件夹下。

步骤3：发布到TestPyPI #

执行发布命令指定使用TestPyPI源，运行后按提示输入验证信息即可：
poetry publish -r testpypi
推荐使用API token验证，用户名固定填写__token__，密码填写你在TestPyPI平台生成的全量token字符串。

步骤4：验证TestPyPI安装 #

发布完成后测试从TestPyPI安装包，确认功能正常：
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ <你的包名>
添加--extra-index-url参数是为了拉取TestPyPI上可能缺失的依赖包。

步骤5：正式发布到PyPI #

确认TestPyPI版本功能无问题后，执行正式发布命令即可：
poetry publish
如果需要合并构建+发布流程，可以直接执行poetry publish --build省略单独构建步骤。

注意：TestPyPI和正式PyPI的账号、API token不通用，需要分别注册生成。

内容的提问来源于stack exchange，提问作者Lukasz Dynowski