配置Composer访问私有仓库需先获取平台个人访问令牌（PAT），再通过composer config -g命令全局配置认证信息，最后清除缓存并测试安装，确保token权限与域名正确。
在使用 Composer 访问私有仓库（如 GitHub、GitLab 或私有 Packagist 服务）时，常因缺少认证 token 导致下载失败。配置正确的 token 是解决这类问题的关键。
1. 获取并生成访问 Token
私有仓库通常要求使用个人访问令牌（Personal Access Token, PAT）代替密码进行认证。以下是常见平台的获取方式：
-
GitHub：进入 Settings → Developer settings → Personal access tokens → Generate new token，勾选
repo权限即可。 -
GitLab：进入 User Settings → Access Tokens，创建新 token 并赋予
read_repository权限。 - 私有 Packagist 服务（如 Satis、Private Packagist）：在用户设置中生成 API token。
生成后请妥善保存 token，页面关闭后将无法再次查看完整值。
2. 配置 Composer 使用 Token
推荐通过 Composer 的全局配置写入 auth 信息，避免明文暴露在项目中。
执行以下命令配置认证：
composer config -g github-oauth.github.com YOUR_GITHUB_TOKEN如果是 GitLab：
composer config -g gitlab-token.gitlab.com YOUR_GITLAB_TOKEN对于自建私有仓库，可在项目根目录的 composer.json 中添加仓库配置：
{ "repositories": [ { "type": "vcs", "url": "https://git.your-private-git.com/user/package.git" } ] }
然后配置对应域名的 HTTP 基础认证或 OAuth token：
composer config -g http-basic.git.your-private-git.com username token3. 清除缓存并测试安装
配置完成后，清除 Composer 缓存以确保新认证生效：
composer clear-cache尝试更新依赖：
composer update若仍提示认证失败，请检查：
- token 是否具有足够权限（如私有仓库读取权限）
- 是否配置了正确的域名（注意 github.com 与 gitlab.com 或自定义域名）
- 网络是否经过代理，需配置 Composer 使用代理
- 本地 composer 缓存是否未刷新
基本上就这些。只要 token 正确且权限完整，Composer 能正常拉取私有包。不复杂但容易忽略细节。
