Composer 用 SSH 访问私有 Git 仓库失败，需确保 URL 格式为 git@host:group/repo.git（冒号分隔）、type 为 "git"、url 以 .git 结尾，并正确配置 ~/.ssh/config 及密钥权限。
Composer 用 SSH 访问私有 Git 仓库失败？先确认 URL 格式对不对
Composer 默认走 HTTPS，想用 SSH 必须显式写 git@xxx 格式，不能只改 composer.json 里的 repositories 地址就完事。常见错误是把 https://gitlab.example.com/group/repo.git 改成 git@gitlab.example.com:group/repo.git 却忘了删掉协议头、补上冒号——SSH URL 的正确分隔符是冒号，不是斜杠。
-
git@gitlab.example.com:group/repo.git✅（冒号 + 路径） -
git@gitlab.example.com/group/repo.git❌（斜杠会被当成路径，Git 报fatal: Could not read from remote repository） - GitHub 用
git@github.com:user/repo.git，GitLab 自托管通常也是类似结构，但端口非 22 时得加ssh://前缀，比如ssh://git@gitlab.example.com:2222/group/repo.git
composer.json 里写错 type 或 url，SSH 根本不会触发
Composer 只在识别出 Git 类型源时才调用 git clone，而 git clone 才会读你的 SSH 配置。如果 type 写成 vcs 或漏写，或者 url 不含 .git 后缀，它可能 fallback 到 HTTP 模式，甚至直接报 Could not fetch 却不提示协议问题。
-
"type": "git"是必须的，不是可选 -
"url"必须以.git结尾，否则 Composer 可能拒绝识别为 Git 源 - 私有包若放在
require里，确保其version对应 Git 分支或 tag，比如"dev-main"或"1.2.0"，否则 Composer 会跳过解析 SSH 配置
SSH Key 不生效？检查 ~/.ssh/config 和权限
Composer 调用的是系统级 git 命令，它完全依赖你本地 ssh 的行为。很多人配了 key 却没配 ~/.ssh/config，导致 git 默认用 git@host 连接，而目标服务器要求特定用户名（如 gitlab）或端口。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
~/.ssh/config里加一段，例如：Host gitlab.example.com User gitlab IdentityFile ~/.ssh/id_rsa_gitlab Port 2222
-
IdentityFile路径必须绝对，且文件权限必须是600（chmod 600 ~/.ssh/id_rsa_gitlab），否则 ssh 直接忽略 - 用
ssh -T git@gitlab.example.com测试不通？别急着改 Composer，先让这句成功 —— Composer 的报错只是 git 的报错转述
CI 环境下 SSH Key 加载失败，是因为没有交互式 shell
很多 CI（比如 GitHub Actions、GitLab CI）默认禁用 SSH agent forwarding，且 ~/.ssh/config 可能不在预期位置。更关键的是：Composer 在非交互式环境里不会自动加载 key，除非你手动 ssh-add。
- CI 脚本里加
ssh-add <(echo "$SSH_PRIVATE_KEY")（注意变量内容要带 BEGIN/END 块） - 确保
SSH_AUTH_SOCK环境变量已设置，否则ssh-add添加无效 - 避免在
composer install前用git clone手动测试 —— 因为 CI 的 git 用户配置可能和 Composer 调用的不一致（比如用了--global设置 user.name/email，但不影响认证）
最常被跳过的环节是：以为改了 composer.json 就够了，其实从 URL 格式、SSH 配置、key 权限到 CI 的 agent 加载，每层都可能静默失败。尤其是 ~/.ssh/config 缺失或 IdentityFile 权限不对，这两个点几乎占了生产环境 SSH 认证失败的七成。
