Composer引用Gitee私有库需解决认证问题：①配置Git凭据助手自动缓存Token；②在composer.json中用HTTPS+Token或环境变量注入；③改用SSH协议并配置密钥；④确保私有库根目录有正确name字段的composer.json。
Composer 能引用 Gitee 私有库，但默认走 HTTPS 协议时会卡在凭据认证环节——不是报 401 Unauthorized，就是提示 Could not authenticate against gitee.com。根本原因：Composer 本身不管理 Git 凭据，它依赖系统级的 Git 凭据助手或手动配置的 HTTP Basic Auth。
配置 Git 全局凭据助手（推荐 macOS / Linux）
让 Git 自动缓存 Gitee 账号密码（或更安全的 Personal Access Token），Composer 执行 git clone 时就能复用：
- 确保已安装 Git 2.11+（支持
manager-core） - 运行：
git config --global credential.helper manager-core
- 首次执行
composer install时，系统弹窗会要求输入 Gitee 用户名和密码（或 Token）；填入后自动保存，后续不再提示 - 注意：Windows 用户若用 Git for Windows，默认已启用
manager-core；macOS 用户可能需先运行git credential-osxkeychain erase清旧凭据再试
在 composer.json 中显式配置 HTTP Basic Auth（兼容所有环境）
直接把认证信息嵌入仓库 URL，适合 CI/CD 或无法调用系统凭据助手的场景。Gitee 支持用 Personal Access Token 替代密码（更安全）：
- 去 Gitee 个人设置 → 私人令牌 创建一个 Token，勾选
repo权限 - 在
composer.json的repositories中写明带认证的 HTTPS 地址：{ "repositories": [ { "type": "vcs", "url": "https://your_token@gitee.com/your-username/your-private-repo.git" } ] } - Token 暴露在
composer.json中有泄露风险，CI 环境建议用环境变量替换："url": "https://${GITEE_TOKEN}@gitee.com/your-username/your-private-repo.git"，然后在 CI 配置中注入GITEE_TOKEN
改用 SSH 协议并配置 SSH Key（适合长期开发）
避免密码/Token 管理，且无需每次输凭据。前提是已在 Gitee 账户添加了 SSH 公钥：
- 确认本地已有可用 SSH key（如
~/.ssh/id_rsa.pub），并已添加到 Gitee SSH 公钥设置页 - 在
composer.json中使用 SSH URL："url": "git@gitee.com:your-username/your-private-repo.git"
- 确保 Composer 能调用
git命令且 SSH agent 正常工作：终端执行ssh -T git@gitee.com应返回成功欢迎语 - 注意：某些容器环境（如 Alpine）默认没装 OpenSSH client，需先
apk add openssh-client
最易忽略的一点：Gitee 私有库的 composer.json 文件必须放在仓库根目录，且 name 字段需与你在项目中 require 的包名完全一致（如 "your-username/your-private-repo": "^1.0"）。否则 Composer 找不到可用版本，报错 Could not find package ... in a version installable using your PHP version。
