Ubuntu22.04下Poetry 1.4.0添加指定Git分支失败，手动克隆正常

数据老陈

2026-7-27

解决方案

以下是几个可尝试的修复步骤：

明确指定分支类型
Poetry 1.x版本在处理Git引用时，有时需要明确标注引用类型。将命令修改为：
```
poetry add git+ssh://git@dev/home/git/projects/jaydebeapi#branch:nanosecond_fix
```
通过branch:前缀告诉Poetry要拉取的是分支而非tag或commit哈希。
验证Poetry使用的Git环境
检查Poetry是否使用了正确的Git客户端，执行以下命令查看配置：
```
poetry config --list
```
如果git.client配置项指向非系统Git路径，手动指定为系统Git：
```
poetry config git.client /usr/bin/git
```
同时确保Poetry运行时的环境变量（如SSH_AUTH_SOCK）与手动执行Git命令时一致，避免SSH密钥认证问题。
本地克隆后添加依赖
绕开Poetry的远程克隆逻辑，先手动克隆仓库到本地：
```
git clone -b nanosecond_fix ssh://git@dev/home/git/projects/jaydebeapi ~/temp-jaydebeapi
```
再通过本地路径添加到Poetry项目：
```
poetry add ~/temp-jaydebeapi
```
后续分支合并后，可再将依赖改回远程URL。
升级Poetry到最新稳定版
Poetry 1.4.0存在一些Git相关的已知bug，升级到新版本可能解决问题：
```
poetry self update
```
升级完成后重新执行原添加命令。