配置Git SSH免密认证是因Composer通过SSH克隆私有仓库时无法交互输入密码，必须依赖密钥自动认证。1. 生成SSH密钥对并保存至~/.ssh/id_rsa；2. 将公钥添加到GitHub/GitLab或服务器authorized_keys；3. 用ssh -T测试连接确保无密码登录成功；4. 确保composer.json中仓库URL为git@格式。只要系统SSH配置正确，Composer即可自动完成克隆，无需额外设置。使用ssh-agent可管理带passphrase的私钥。
Composer 在安装或更新依赖时，如果项目依赖的是私有 Git 仓库（比如 GitHub、GitLab 或自建 Git 服务），通常会通过 Git 克隆代码。若使用 SSH 协议，就需要配置 SSH 免密认证，否则 Composer 执行时会卡住或报权限错误。
为什么需要配置 Git SSH 免密认证
当 Composer 需要从私有 Git 仓库拉取代码时，例如：
"repositories": [ { "type": "vcs", "url": "git@github.com:username/private-package.git" } ]Composer 会调用系统的 git clone 命令。如果使用的是 git@... 这类 SSH 地址，系统会尝试用 SSH 登录远程服务器。如果没有配置 SSH 密钥对和免密登录，就会提示输入密码，而 Composer 不支持交互式输入，导致失败。
配置 SSH 免密认证的步骤
要让 Composer 顺利拉取私有仓库代码，需完成以下设置：
1. 生成 SSH 密钥对（如尚未创建） ssh-keygen -t rsa -b 4096 -C "your_email@example.com"按提示保存密钥（默认路径为 ~/.ssh/id_rsa），可设置密码（passphrase），但建议留空以实现完全免密。若设置了 passphrase，后续需配合 ssh-agent 使用。
2. 将公钥添加到 Git 服务将生成的公钥（通常是 ~/.ssh/id_rsa.pub）内容复制到对应平台：
- GitHub: Settings → SSH and GPG keys → New SSH key
- GitLab: Preferences → SSH Keys
- 自建 Git 服务器: 将公钥追加到服务器用户 ~/.ssh/authorized_keys 文件中
如果是 GitHub，成功后会看到类似：
Hi username! You've successfully authenticated, but GitHub does not provide shell access.
其他平台也有类似测试方式，确保能无密码连接。
确保你的包仓库 URL 使用的是 SSH 格式：
"url": "git@github.com:username/private-package.git"而不是 HTTPS 地址（如 https://github.com/...），HTTPS 通常需要 token 认证，不适合自动拉取。
Composer 如何使用 SSH 配置
Composer 本身不管理 SSH，它调用系统已安装的 Git 和 SSH 工具。只要：
- SSH 密钥存在且权限正确（~/.ssh/id_rsa 权限应为 600）
- 公钥已添加到 Git 服务
- Git 仓库地址是 SSH 协议
Composer 就能自动完成克隆，无需额外配置 Composer 文件。
小技巧：使用 ssh-agent 管理带密码的密钥如果你的私钥设置了 passphrase，可以启动 ssh-agent 自动管理：
eval $(ssh-agent)ssh-add ~/.ssh/id_rsa
然后运行 composer install，即可免重复输入密码。
基本上就这些。只要系统层面配置好 SSH 免密，Composer 拉取私有 Git 仓库就不会再出问题。
