Composer开发环境必备：国内镜像加速-composer-PHP中文网

composer config -g repo.packagist 命令总不生效，主因是三个硬伤：键名必须为单数repo.packagist（非repos.packagist）、第二参数必须显式指定composer类型、url须https且末尾带/，任一缺失均静默回退官方源；验证需输出完整json如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。

composer开发环境必备：国内镜像加速

composer config -g repo.packagist 命令总不生效？检查这三个硬伤

绝大多数人配完镜像后 composer install 依然卡在 Downloading，不是网络问题，是命令根本没写对——Composer 2.x+ 静默 fallback 到官方源，不报错也不提示。

repo.packagist 必须是单数、小写，写成 repos.packagist（多一个 s）或 packagist.org 都无效
中间的 composer 是 type 值，不是可选参数，漏掉它就等于没配
URL 必须是 HTTPS 且末尾带 /，比如 https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出 /composerpackages.json 导致 404）

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

项目级配置怎么安全追加，不覆盖私有仓库

全局配置在宝塔、CI、团队协作中不可靠——sudo -u www composer config -g 写的是 www 用户的配置，而 composer install 可能由另一个用户执行；Git 也无法跟踪全局配置。

First Principles Decomposer

把任何问题拆解为根本真理，再从原子层面重建解决方案。

下载

进项目根目录（含 composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加 -g）
这条命令会自动在 composer.json 的 repositories 对象里追加 "packagist" 条目，不破坏原有结构
如果 repositories 原本是数组（如 [{"type": "vcs", "url": "..."}]），命令仍能正确插入新项；但若手动编辑 JSON，极易引号不全、括号错位、误删已有源
别写 "packagist.org": false ——这会导致基础扩展（如 ext-json）校验失败，composer install 直接报错

换源后 still stuck at “Resolving dependencies”？和镜像无关

镜像只加速元数据请求（packages.json）和 tarball 下载，不影响依赖解析阶段。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，基本可以排除镜像问题。

"php": "^7.4 || ^8.0" 这类宽泛约束会让 Composer 尝试大量版本组合
require-dev 里塞了未锁定的工具链（如 "phpunit/phpunit": "^9"），每次解析都要重新计算兼容性
存在大量 dev- 分支依赖，或 composer.lock 长期未更新，触发全量重算
临时解法是删掉 vendor/ 和 composer.lock 后重跑 composer install，但根源在于收紧版本约束和清理 dev 依赖

宝塔、CI、计划任务里全局配置为啥不起作用

全局配置写在 /root/.composer/config.json，但它只对 root 用户生效。宝塔「一键部署」默认以 www 用户运行，GitHub Actions 用 runner 用户，它们根本读不到你的 root 配置。

先确认实际执行用户：在宝塔终端执行 whoami，或查日志里的 UID
给对应用户单独配：比如是 www 用户，就运行 sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI 脚本中，确保 composer config -g 和后续 composer install 在同一用户上下文执行
别指望 sudo composer config -g 写进 root 配置后，普通用户就能自动继承——Composer 不做跨用户配置共享