无法通过Poetry从私有GitHub仓库安装含指定依赖的私有包

问题分析 #

1. 目标包的pyproject.toml仅包含[tool.poetry.dependencies]配置段，缺少标准的[project].dependencies，导致pip无法识别并安装子依赖。
2. 执行poetry add命令时出现连接错误，核心原因是URL格式错误：命令中的https://<username>:<token>@github.com/...被错误解析，把<username>当成了请求的host，而非GitHub的域名。

解决方案 #

1. 修正私有仓库的URL格式 #

使用正确的HTTPS格式，确保@后面紧跟github.com，避免解析拆分错误：

poetry add git+https://<token>@github.com/<username>/<package>.git

若场景需要指定用户名，正确格式应为：

poetry add git+https://<username>:<token>@github.com/<username>/<package>.git

2. CI/CD环境下的安全写法 #

在CI/CD流程中，建议将token存入环境变量（比如GITHUB_TOKEN），避免明文暴露：

poetry add git+https://${GITHUB_TOKEN}@github.com/<username>/<package>.git

Poetry会自动解析环境变量，同时避免token被日志记录。

3. 确认Poetry版本兼容性 #

确保使用Poetry 1.2.0及以上版本，这类版本对仅含[tool.poetry.dependencies]的pyproject.toml解析支持更完善，能正确识别并安装子依赖。

验证 #

执行修正后的命令后，Poetry会自动拉取私有仓库代码，并解析[tool.poetry.dependencies]中的子依赖完成安装，无需修改目标包的配置文件。

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