Composer不处理SSH密钥，问题根源在Git+SSH层；必须确保git clone git@host:path.git静默成功，再验证ssh-add -l、ssh-T及~/.ssh/config三步，且composer.json中url须为git@host:path.git格式并设type为"vcs"。
Composer 本身不处理 SSH 密钥，冲突根源在 Git + SSH 层；只要 git clone git@host:path.git 失败，Composer 就会卡住或降级报错，必须先让 Git 能静默走通 SSH。
ssh-add -l 显示为空？密钥根本没加载进 agent
很多开发者以为生成了密钥就万事大吉，但 macOS/Linux 默认不自动把私钥喂给 ssh-agent，Windows Git Bash 也常处于未启动状态。结果就是 ssh -T git@github.com 直接报 Permission denied (publickey)，而 Composer 在背后默默重试、超时、再 fallback 到 HTTPS——你只看到 “Could not fetch”，却找不到源头。
- 运行
eval "$(ssh-agent -s)"确保 agent 启动（macOS/Linux）；Windows Git Bash 可直接用ssh-agent bash - 用
ssh-add ~/.ssh/id_ed25519_github手动加载每把私钥（路径按实际调整） - 检查权限：
chmod 600 ~/.ssh/id_ed25519_github，否则ssh-add会静默拒绝 - 验证是否生效：
ssh-add -l应列出指纹，ssh -T git@github.com应返回Hi xxx!
composer.json 中 url 写成 https:// 就永远绕不开 SSH 冲突
Composer 的 repositories 配置里，只要 url 是 https:// 或带 git:// 前缀，Git 就不会尝试 SSH 协议，自然也不会读 ~/.ssh/config，更不会触发多账号分流。你以为在修 Composer，其实一直在修错层。
使用约定式提交（Conventional Commits）从 Git 历史记录中生成结构化变更日志，支持多种格式、AI 增强型描述以及可自定义的范围……
- 正确写法只有一种：
"url": "git@gitlab.com:org/private-repo.git"（结尾必须有.git） - 错误写法包括：
"url": "https://gitlab.com/org/repo.git"、"url": "git@gitlab.com/org/repo.git"（用了/，Git 解析为 HTTPS）、"url": "ssh://git@gitlab.com/org/repo.git"（多数服务不支持） - 务必确认
"type": "vcs"显式声明，否则 Composer 可能忽略该仓库
~/.ssh/config 中 Host 别名没匹配上，Git 就不知道该用哪把密钥
Git 克隆时解析远程 URL，只认 git@host: 中的 host 字段。如果你配置的是 Host github.com，但仓库 URL 是 git@github.com-personal:org/repo.git，那它根本不会命中配置段——别名必须和 URL 中的 host 完全一致，或通过通配符覆盖。
- 推荐做法：为每个账号/平台定义独立别名，如
Host github-personal、Host github-work - 对应仓库 URL 改成
git@github-personal:org/repo.git，并确保HostName github.com在配置中指向真实域名 - 加
IdentitiesOnly yes，防止 ssh-agent 把其他密钥也塞过去，引发平台误认 - 测试配置是否生效：
ssh -F ~/.ssh/config -T git@github-personal（显式指定 config 文件）
多个私有包来自不同平台时，不能只靠默认密钥
当 composer.json 里同时引用 GitHub、GitLab 和自建 Gitea 的私有包，且它们绑定了不同账号，仅靠 ~/.ssh/id_ed25519 这一把密钥是不够的——Git 会随机选一把去连所有 host，失败率极高。真正的隔离靠的是 ~/.ssh/config 的 Host 分流 + IdentityFile 绑定，而不是密钥文件名本身。
容易被忽略的一点是：Composer 不会主动 reload ~/.ssh/config，它完全依赖系统 Git 的行为。所以改完 config 后，一定要用 git clone 手动验证每个 URL 是否能免密拉下代码，再跑 composer install。否则你看到的 “Cloning into…” 卡住，大概率是某一个 git clone 在后台静默失败了。
