Composer镜像加速：项目开发的必经之路-composer-PHP中文网

composer全局镜像配置config -g repo.packagist常静默失效，主因是键名必须为单数repo.packagist、第二参数必须显式指定composer类型、url须以https://开头且末尾带/；任一缺失即回退官方源，且项目级repositories字段会完全覆盖全局配置。

composer镜像加速：项目开发的必经之路

Composer 默认直连 packagist.org，国内访问延迟高、TLS 握手慢、常卡在 Downloading 或报 could not find package ——这不是你网络差，是必须换镜像的信号。

composer config -g repo.packagist 命令为什么总不生效

它不报错，但实际没写进去，最终静默 fallback 回官方源。核心就三点：

repo.packagist 不能写成 repos.packagist（多一个 s 就彻底忽略）
第二个参数必须是 composer（这是仓库类型声明，漏掉会走默认源）
URL 必须以 https:// 开头，且末尾带 /：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌

验证是否成功：运行 composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串。如果为空、null、或仍是 https://packagist.org，说明完全没写进去。

项目级配置会清空你原有的私有源

执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）时，它不是“追加”，而是全量替换当前项目的 composer.json 中的 repositories 字段。

如果你原本配了 Git 私有包源，比如：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

"repositories": {
  "my-private": { "type": "vcs", "url": "https://git.example.com/pkg" }
}

这条命令一跑，整个 repositories 就只剩阿里云镜像，私有源直接消失。

正确做法是手动编辑 composer.json，确保：

repositories 是数组格式（不是对象），首位为：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
根节点写上 "packagist.org": false（注意：不在 repositories 内部，而在顶层）
改完删掉 vendor/ 和 composer.lock，再跑 composer install

宝塔、CI、systemd 里镜像还是慢？用户不对

composer config -g 写的是当前用户的配置路径：~/.composer/config.json（Linux/macOS）或 %APPDATA%\Composer\config.json（Windows）。但宝塔后台、Jenkins、systemd 服务往往以 www、jenkins 或其他用户身份运行，根本读不到你 root 或个人用户的配置。

排查和解决方式：

在宝塔 PHP 管理器里点「一键部署」前，先用该用户身份执行：sudo -u www composer config -g repo.packagist，看是否输出预期 JSON
CI 脚本别依赖全局配置，改用临时参数：composer install -vvv --repository=https://mirrors.aliyun.com/composer/
-vvv 很关键——它会打印真实请求 URL，一眼就能确认走的是哪个源

最易被忽略的点：镜像只加速元数据拉取和 tarball 下载，不解决 Resolving dependencies 卡顿。如果卡在这里，得收紧 php 版本约束、删掉 "minimum-stability": "dev"、关掉 xdebug，而不是继续折腾镜像。