常见原因有三：一是系统未安装 git 或未将其路径加入环境变量；二是网络超时，因 pip 调用 git clone 时不受 pip -i 镜像参数影响；三是 url 格式错误，如误用 # 而非 @ 指定分支或 tag。
pip install git+https:// 会失败的常见原因
直接运行 pip install git+https://github.com/username/repo.git 报错“command 'git' not found”，不是 pip 问题，而是系统根本没装 Git 或没配进环境变量。Windows 用户尤其容易卡在这一步——下载安装 Git 后，必须手动把 Git\bin 和 Git\mingw64\bin（或 Git\cmd）加进系统 PATH，否则 cmd/PowerShell 里连 git --version 都不认。
另一个高频错误是网络超时：pip 底层调用的是 git clone，它走的是 Git 自己的 HTTP/HTTPS 协议栈，和 pip 的 -i 镜像参数完全无关。加了 -i https://pypi.tuna.tsinghua.edu.cn/simple/ 对 GitHub URL 无效，纯属白忙活。
指定分支、Tag 或 Commit 的正确写法
GitHub URL 后面用 @ 追加版本标识，不是所有格式都等效：
-
pip install git+https://github.com/psf/requests.git@main→ 安装 main 分支最新代码 -
pip install git+https://github.com/KAIR-BAIR/nerfacc.git@v0.5.2→ 安装 tag v0.5.2 对应的 release -
pip install git+https://github.com/pytorch/vision.git@8e0a7da→ 安装指定 commit（长度建议至少 7 位） - 错误示范：
pip install git+https://github.com/xxx/yyy.git#v1.2.3——#是注释符，会被忽略，实际仍装 master
没有 Git 时的替代方案：本地路径安装
如果你只是临时想跑通一个项目，又不想折腾 Git，可以跳过 clone 步骤：
- 浏览器打开 GitHub 项目页 → 点 “Code” → “Download ZIP” → 解压到本地，比如
D:\myproject - 确保解压后目录里有
setup.py或pyproject.toml - 运行
pip install D:\myproject（注意末尾没有斜杠） - 如果要边改代码边测试，改用
pip install -e D:\myproject，这样修改源码后无需重装就能生效
注意：pip install . 必须在项目根目录下执行；而 pip install D:\myproject 可以在任意位置运行，更灵活。
国内加速必须绕开 pip -i，改用代理或镜像地址
GitHub 原始链接下载慢，核心矛盾在于：pip 不解析也不重写 URL，它只负责发起请求。所以加速只能从 URL 本身下手：
- 用
ghproxy.com中转：pip install https://ghproxy.com/https://github.com/xxx/yyy/archive/refs/tags/v1.0.tar.gz - 用 Gitee 同步后安装：
pip install https://gitee.com/username/repo/repository/archive/master.zip - 配置 Git 代理（仅对
git+有效）：git config --global https.proxy http://127.0.0.1:7890
最易忽略的一点：很多项目用 git+ssh:// 协议（如 git+ssh://git@github.com:user/repo.git），这种必须走 SSH 密钥认证，ghproxy 类服务完全不支持，此时只能换 HTTPS 地址或配好本地 SSH。
