如何使用Poetry从TestPyPI安装delta-spark预发布版本？

你遇到的核心问题是TestPyPI仓库的URL配置错误，正确的包索引地址应当是https://test.pypi.org/simple/，而非你之前配置的https://test.pypi.org/。以下是完整的解决步骤：

1. 修正TestPyPI仓库配置 #

先移除之前错误的仓库配置（如果存在），再添加正确的源：

# 移除错误的test-pypi仓库配置
poetry config --local repositories.test-pypi --unset
# 添加正确的TestPyPI源（必须带/simple/路径）
poetry source add --secondary test-pypi https://test.pypi.org/simple/

执行完成后，你的pyproject.toml会生成正确的源配置：

[[tool.poetry.source]]
name = "test-pypi"
url = "https://test.pypi.org/simple/"
secondary = true

2. 安装delta-spark预发布版本 #

需要同时指定允许预发布版本和从test-pypi仓库拉取包，执行对应命令：

# 安装到项目默认依赖组
poetry add delta-spark==2.1.0rc1 --allow-prereleases --source test-pypi

# 如果要安装到dev依赖组，使用这条命令
poetry add delta-spark==2.1.0rc1 --allow-prereleases --source test-pypi --group dev

失败原因说明 #

• 未指定TestPyPI源时，Poetry默认从官方PyPI拉取包，而该预发布版本仅存在于TestPyPI
• 仓库URL缺少/simple/路径，导致Poetry无法正确识别包索引地址
• 仅添加仓库但未指定从该源拉取，Poetry会优先从官方源查找，找不到就直接报错

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