Composer clone失败主因是镜像不代理Git克隆，需从协议切换（如config -g github-protocols ssh）、启用--prefer-dist、修复SSH配置或处理代理SSL干扰三方面解决。
Composer clone 失败，90% 不是镜像问题，而是你混淆了「元数据拉取」和「Git 仓库克隆」——中文镜像只加速 packages.json 和 ZIP 包下载，对 git clone 完全无效。想解决 clone 卡住或失败，得从协议、SSH 配置、网络策略三处下手。
为什么换阿里云镜像后 still 报 “Failed to clone https://github.com/xxx”
中文镜像（如 https://mirrors.aliyun.com/composer/）只代理 Packagist 的元数据和 dist ZIP 包，不托管任何 Git 仓库。当某个包在 composer.json 中声明了 "source": {"url": "https://github.com/..."}，Composer 就会直接执行 git clone https://...，完全绕过镜像源。
- 这是正常行为，不是镜像没生效
- 常见于 dev 分支依赖、私有包、或启用了
"prefer-source": true的项目 -
composer install -vvv日志里出现Cloning into 'vendor/xxx'或Executing command (CWD): git clone --no-checkout，就说明已进入 Git 阶段，镜像彻底无关
强制 Composer 走 SSH 而非 HTTPS 克隆
企业防火墙常拦截出向 HTTPS（尤其是非 443 端口），但允许 SSH（22 端口）。只需告诉 Composer：GitHub 域名一律改用 SSH 协议。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g github-protocols ssh（Composer 2.2+ 支持） - 验证是否写入：
composer config -g github-protocols应输出["ssh"] - 确保本地 SSH key 已加载：
ssh -T git@github.com必须返回Hi xxx! You've successfully authenticated - 若失败，补操作：
eval "$(ssh-agent -s)" && ssh-add ~/.ssh/id_ed25519 - 注意：该配置不影响 GitLab 或其他域名，如需一并处理，加
gitlab-protocols同理
临时禁用 HTTPS 克隆，回退到 ZIP 下载
不是所有包都必须走 Git；只要包提供了 dist（ZIP/TAR 归档），就能跳过 clone 步骤。前提是包作者发布了 release，且你的 composer.json 没强制要求 source。
- 删掉
composer.lock和vendor/，再运行：composer install --prefer-dist - 全局默认设为 dist：
composer config -g prefer-dist true - 检查是否生效：
composer config -g prefer-dist应输出true - 若仍 clone，说明该包未发布 dist（比如只推了 tag 但没建 GitHub Release），此时只能修包或联系作者
公司代理/HTTPS 解密导致 clone 失败怎么办
某些安全网关（如 Zscaler、Netskope）会中间解密 HTTPS 流量并重签证书，而 Composer 默认校验 CA 证书链，导致 git clone https://... 直接失败。
- 先验证：
curl -I https://github.com若报 SSL 错误，基本可确认是代理干扰 - 临时绕过（仅调试）：
GIT_SSL_NO_VERIFY=1 composer install - 长期方案：把代理的根证书导出为 PEM，配置 Git：
git config --global http.sslCAInfo "/path/to/proxy-ca.pem" - 不推荐设
http.sslVerify false全局关闭，存在安全风险
最易被忽略的一点：github-protocols 配置只影响 Composer 自动生成的 Git URL，如果你在 repositories 里手动写了 "url": "https://github.com/xxx"，它不会被重写——这种写法必须自己改成 "git@github.com:xxx/yyy.git" 才能走 SSH。
