命令不生效是因为漏了三个硬性要素：键名必须为 repo.packagist（非 repos）、type 值必须显式声明为 composer、url 必须以 https 开头且末尾带 /；缺一即静默失败。
composer config -g repo.packagist 命令为什么总不生效
因为漏了三个硬性要素中的任意一个，命令就静默失败——不报错、不提示、照样连 packagist.org。最常出错的是：repo.packagist 写成 repos.packagist（多一个 s），composer 这个 type 值被省略，或者 URL 少了末尾斜杠 /。
正确写法只有一条：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
-
-g不能省：缺了就只改当前目录的composer.json，换项目就失效 -
repo.packagist是唯一合法键名：拼错或复数形式都无效 -
composer是必须声明的 type 值：不是注释，也不是可选参数 - URL 必须 HTTPS + 末尾
/：少斜杠会导致路径拼成/composerpackages.json，返回 404
验证是否写入成功，直接运行：composer config -g repo.packagist。输出应为完整 JSON 对象，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或仍是 https://packagist.org，说明没生效。
项目级配置比全局更可靠，尤其在 CI 和团队协作中
全局配置看着省事，但实际容易被绕过：宝塔用 www 用户执行、GitHub Actions 用 runner 用户、Docker 构建用非登录用户——它们都读不到你本地 root 或 admin 的全局配置。
进项目根目录后执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
- 该命令会自动向
composer.json的repositories字段追加"packagist"条目，不覆盖已有私有源 - 如果项目已有
"repositories": {}，别手动编辑 JSON——格式错一个逗号就会让composer install直接报错 - 配置随代码提交，新人
git clone后composer install行为一致 - CI 流水线无需额外 setup，每次构建都读取最新设置
注意："packagist": false 这种写法会彻底屏蔽镜像，必须确保是 "packagist": true 或干脆不写该字段。
换源后仍卡在 Downloading 或 Resolving dependencies？和镜像无关
镜像只加速下载阶段（Downloading），不解决依赖解析慢的问题。如果你看到卡在 Resolving dependencies 几十秒甚至几分钟，基本可以确定是以下原因：
- PHP 内存不足：默认
128M不够，临时加COMPOSER_MEMORY_LIMIT=-1再试 - Xdebug 启用中：会让解析慢 5–10 倍，用
php -d xdebug.mode=off $(which composer) install临时禁用 -
composer.json里 PHP 版本约束太宽，比如"php": "^7.4 || ^8.0"，会让 Composer 尝试大量组合 - require-dev 里塞了太多工具包，或用了大量未锁定的
dev-main分支
另外，换源后首次 composer install 若报 hash 校验失败，必须删掉 vendor/ 和 composer.lock 重来——旧 lock 文件记录的是 packagist.org 的包哈希，和镜像返回的元数据不兼容。
怎么确认真走镜像了，而不是 fallback 到官方源
光看 composer config -g repo.packagist 输出没用，得看到网络请求实际打到镜像域名才算数。
实测命令：composer show monolog/monolog -vvv 2>&1 | grep "Downloading"
- 日志里必须出现
mirrors.aliyun.com或mirrors.cloud.tencent.com等镜像域名 - 如果看到
https://packagist.org或repo.packagist.org，说明 fallback 触发了，配置没起作用 - 遇到 fallback，优先检查
composer.json是否存在"packagist": false或"repositories"数组里误删了 packagist 条目
阿里云镜像同步频率是 15 分钟，腾讯云 30 分钟，中科大 1 小时——新发布的包可能略有延迟，但日常开发完全够用。真正卡住的时候，90% 都不是镜像问题，而是本地环境或依赖写法的问题。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
