git clone正常但pip install同远程URL失败：私有SSH仓库安装求助

我来帮你排查下这个问题——既然git clone能正常执行，说明你的SSH认证本身是没问题的，大概率是pip/pipenv解析私有仓库URL的规则和git不一样，或者虚拟环境里的SSH配置没正确继承。下面是几个你可以逐一尝试的解决方案：

1. 严格遵循pip要求的Git SSH URL格式 #

pip对Git仓库的URL有特定格式要求，这是最容易踩坑的点：

• 必须带上git+ssh://前缀（或者用git的SSH简写格式，但要注意符号转换）
• 必须添加#egg=你的包名后缀，这是pip用来识别包名称的关键，没有的话pip会直接报错找不到包
• 如果要指定分支、标签或commit，需要在URL末尾加@分支名/标签名/commit哈希

举个正确的例子（假设你的仓库是git@git.example.com:my-team/my-private-package.git，标签是v1.2.3，包名是my-package）：

# pip+virtualenv 命令
pip install git+ssh://git@git.example.com/my-team/my-private-package.git@v1.2.3#egg=my-package

# Pipenv 命令
pipenv install git+ssh://git@git.example.com/my-team/my-private-package.git@v1.2.3#egg=my-package

注意：SSH简写格式里的冒号:，在pip的URL里要改成斜杠/，直接用完整的git+ssh://格式可以避免这类符号混淆问题。

2. 验证虚拟环境内的SSH认证是否正常 #

有时候你本地的SSH密钥是通过ssh-agent加载的，但虚拟环境可能没继承这个代理的环境变量。可以先在激活的虚拟环境里运行：

ssh -T git@git.example.com

如果输出类似Hi username! You've successfully authenticated, but GitHub does not provide shell access.（对应GitHub）或者类似的成功提示，说明认证没问题；如果报错，需要：

• 确保本地的ssh-agent在运行，并且你的密钥已经添加进去（用ssh-add -l可以查看已加载的密钥）
• 如果用Pipenv，可以尝试让它强制继承系统的环境变量：

  PIPENV_VENV_INHERIT=1 pipenv install git+ssh://git@git.example.com/my-team/my-private-package.git#egg=my-package
  

3. 升级pip到最新版本 #

旧版本的pip对Git SSH URL的支持有不少bug，比如解析标签/分支时出错。先在虚拟环境里升级pip：

# pip+virtualenv
pip install --upgrade pip

# Pipenv
pipenv run pip install --upgrade pip

4. 尝试用requirements.txt文件安装（针对pip+virtualenv） #

有时候直接在命令行输入长URL容易出错，把URL写到requirements.txt里再安装更稳定：

# requirements.txt 内容
git+ssh://git@git.example.com/my-team/my-private-package.git@v1.2.3#egg=my-package

然后运行：

pip install -r requirements.txt

5. 检查仓库内的打包配置文件 #

如果上面的步骤都没用，可能是仓库里的setup.py、setup.cfg或pyproject.toml有问题：

• 确保setup.py里的name字段和#egg=xxx里的xxx完全一致
• 检查打包配置是否完整，比如有没有正确定义packages、version等必要字段

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