composer全局镜像配置未生效，根本原因是键名必须为单数repo.packagist、type值必须显式写composer、url必须以/结尾，三者缺一即静默回退官方源；且项目级composer.json中存在repositories字段时会无条件覆盖全局配置。
composer config -g repo.packagist 为什么没生效
命令看似执行成功，但composer install仍连packagist.org，大概率不是镜像地址错了，而是配置被覆盖或根本没写进去。
- 项目根目录存在
composer.json且含"repositories"字段时，全局配置repo.packagist完全失效——Composer 优先读项目级配置 - Windows 下用 PHPStudy/XAMPP 时，
composer config -g可能因权限不足写入失败，实际配置文件（如C:\Users\XXX\AppData\Roaming\Composer\config.json）没更新 -
php.ini里若禁用了proc_open或putenv，命令会静默失败，不报错也不写入 - 键名必须是
repo.packagist（不是repos.packagist或repository），type值必须是小写composer，URL 必须以/结尾（https://mirrors.aliyun.com/composer/✅，少斜杠会拼接出错）
项目级配置怎么写才不踩坑
想让配置随代码提交、CI 环境自动生效，就得改composer.json，但顺序和结构稍错就白忙活。
- 在
composer.json根节点下添加"packagist.org": false，不是塞进repositories数组里——放错位置就无效 -
repositories必须是数组，每个源对象都要带"type": "composer"，别写成"type": "package"或漏掉type - 阿里云放前面：
{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}，官方源放后面，仅当阿里云返回 404（包真不存在）才触发回退；超时、502 不会切源 - 改完立刻删掉
vendor/和composer.lock，再跑composer install——旧 lock 文件会锁死旧源
Docker 里镜像配置为什么总丢
很多人在 Dockerfile 的构建阶段配了镜像，结果运行时还是慢，问题出在配置没落到 PHP 容器里。
- 多阶段构建中，
composer:latest镜像里的配置不会自动同步到php:8.2-fpm-alpine这类运行镜像 - 正确做法是在 PHP 镜像的 RUN 指令里重配：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 或者更稳妥：把配置文件 COPY 进容器对应用户目录，比如
/root/.composer/config.json（root 用户）或/var/www/.composer/config.json（www-data 用户） - 如果用
COPY --from=composer /app/vendor /var/www/html/vendor，确保构建阶段也用了镜像源，否则 vendor 里包还是从国外拉的
换源后还卡在 Resolving dependencies 怎么办
镜像只加速下载，不解决依赖解析阶段的卡顿。这时composer install停在“Resolving dependencies”不动，跟镜像无关。
- PHP 内存不够：默认 128M 常常不够，临时加
COMPOSER_MEMORY_LIMIT=-1再试 - Xdebug 开着：会让解析慢 5–10 倍，CLI 下用
php -d xdebug.mode=off $(which composer) install临时禁用 -
platform配置和实际 PHP 版本不匹配：比如"php": "7.4"却在 PHP 8.2 上跑，会触发降级查找逻辑，拖慢整个过程 - 依赖本身有冲突：用
composer why-not vendor/package:version定位具体哪个包在阻塞
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
