私有库用 git+https:// 安装失败的根本原因是 GitHub/GitLab 对未认证 HTTPS 访问返回 404 而非 401，导致 pip 误判为仓库不存在；必须使用带 repo 权限的 Personal Access Token（需 URL 编码）嵌入 URL，或改用 SSH 协议（需配置密钥并验证 ssh -T）。
私有库用 git+https:// 直接安装，为什么总卡在 404 或认证失败
根本原因不是 pip 有问题，而是 GitHub/GitLab 对私有仓库的 HTTPS 访问做了严格限制：未认证时直接返回 404 Not Found（不是 401），让 pip 误判为“仓库不存在”。这不是 URL 写错了，是权限没走通。
- GitHub 私有库不支持纯 HTTPS 密码登录（2021 年起已禁用）
- 即使你浏览器能打开页面，
git clone https://...仍会失败——因为网页登录态 ≠ Git CLI 认证态 - 报错典型形态：
ERROR: Command errored out with exit status 128: git clone ... fatal: unable to access 'https://github.com/xxx/yyy.git/': The requested URL returned error: 404
HTTPS 方式装私有库，必须用 Personal Access Token（PAT）
不能输密码，也不能留空。必须生成带 repo 权限的 PAT，并嵌入 URL 中。
Github Stars Analyzer
下载
抓取指定 GitHub用户的 Stars 项目，生成标准化中文 Markdown 报告。用户提及「分析 GitHub stars」「导出收藏项目」「汇总 GitHub 星标」「生成 stars 报告」或粘贴含 ?tab=stars 的链接时触发。执行通过 bash...
- 生成 PAT：GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token → 勾选
repo（必要）、delete_repo（可选） - 正确写法：
pip install git+https://<strong>YOUR_TOKEN</strong>@github.com/owner/repo.git - 注意：token 要 URL 编码（如含
/、+等特殊字符），可用 Python 快速处理：from urllib.parse import quote; print(quote("your-token")) - Windows 命令行中，
@符号可能被解析异常，建议用双引号包裹整个 URL：pip install "git+https://abc123@github.com/owner/repo.git"
比 HTTPS 更稳的方式：改用 SSH 协议
SSH 不依赖 token，靠本地密钥对认证，一次配好长期有效，且不会被误判为 404。
- 前提：本地已生成 SSH key（
ssh-keygen -t ed25519），且公钥已添加到 GitHub/GitLab 账户 SSH Keys 设置中 - 验证是否生效：
ssh -T git@github.com（应返回 Hi xxx! You've successfully authenticated） - 安装命令：
pip install git+ssh://git@github.com:owner/repo.git（注意是:不是/）或更标准写法：pip install git+ssh://git@github.com/owner/repo.git - 企业内网 GitLab 若用非标准端口（如 2222），需显式写出：
git+ssh://git@host:2222/group/repo.git
requirements.txt 里写 git+ 依赖，容易漏掉的三个坑
不是写对语法就万事大吉，环境和上下文决定它能不能跑通。
-
-e模式（editable install）对私有库更安全：它把仓库克隆到本地再安装，便于调试，且避免每次 install 都重新 clone；写法：-e git+ssh://git@github.com/owner/repo.git@main#egg=repo_name - 分支/commit/tag 必须存在且可访问：比如写
@v1.2.0，但该 tag 在私有库中尚未 push，就会报Could not find a tag or branch - 子目录结构要显式声明：如果
setup.py不在仓库根目录（例如在src/下），必须加#subdirectory=src，否则 pip 找不到构建入口
