composer config -g repo.packagist 命令未生效是因为键名必须为 repo.packagist（单数，不可多s）、第二参数必须显式指定 composer 类型、URL 必须以 https:// 开头且末尾带 /，三者缺一即静默失效，输出为空或仍为官方源。
composer config -g repo.packagist 命令为什么没生效
它根本没写进去，但 Composer 一声不吭——这是国内开发者踩得最多的坑。关键就三点：repo.packagist（不能多 s 或少 repo.）、composer（必须作为 type 值显式写出）、https://mirrors.aliyun.com/composer/（末尾斜杠 / 不可省）。漏掉任意一个，命令就静默失败，composer config -g repo.packagist 输出为空或仍是 https://packagist.org。
验证是否成功，只看这一行输出：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。不是 JSON、不是纯 URL、不是 null，都说明没配对。
- Windows 用户配置文件在
C:\Users\用户名\AppData\Roaming\Composer\config.json，别手改，用命令写入最稳 - Mac/Linux 默认写入
~/.composer/config.json，但注意权限：如果用sudo执行过 composer，可能写进了 root 目录，而你日常用普通用户运行，就读不到 - 新版 Composer（2.2+）
composer config -g repo.packagist可能只输出 URL 字符串，只要它是阿里云或清华源的完整地址，就算生效
项目级镜像配置怎么避免破坏已有私有源
团队协作或 CI 构建时，全局配置靠不住——宝塔用 www 用户、GitHub Actions 用 runner 用户、Docker 容器里甚至没有 ~/.composer 目录。这时必须把镜像写进项目本身，且不能覆盖已有的私有仓库。
正确做法是进项目根目录（含 composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加 -g）。
立即学习“PHP免费学习笔记（深入）”；
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 如果原
composer.json是"repositories": {}（空对象），命令会自动转成标准数组并插入 packagist 条目 - 如果原
repositories已是数组（如[{"type":"package","url":"..."}]），命令会在末尾追加新项，不碰已有内容 - 千万别手动写
"packagist": false——这会导致php、ext-json等基础平台约束校验失败，composer install直接报错退出 - 改完必须删掉
vendor/和composer.lock，再跑composer install，否则旧 lock 文件仍指向官方源
为什么配了镜像还是卡在 “Loading composer repositories”
日志里出现 Loading composer repositories 却迟迟不动，说明请求压根没发到镜像站——大概率是项目级 repositories 配置覆盖了全局设置，或者 composer.json 里写了硬编码的 "packagist.org": false 这类禁用语句。
快速定位：加 -vvv 参数重跑命令，比如 composer install -vvv，盯住日志里第一行 HTTP 请求的域名。如果是 packagist.org，那镜像就没走通。
- 检查
composer.json顶层是否有"repositories"字段，且里面是否包含"packagist": false或"type": "composer", "url": "https://packagist.org" - 运行
composer diagnose，它会明确告诉你当前实际使用的 repository URL 是什么 - 某些老旧包（尤其 2020 年前发布的）在
dist.url里硬编码 GitHub 地址，导致绕过镜像——此时需配 GitHub Token：composer config -g github-oauth.github.com your_token_here
CI/CD 或首次部署时怎么跳过“隐形拖累”
镜像只加速下载，但 composer install 卡住更多是因为脚本、autoload 生成、dev 依赖这些非必要环节。生产环境或自动化流程里，它们全是干扰项。
推荐组合命令：composer install --no-dev --no-scripts --no-autoloader --prefer-dist。装完再单独跑 composer dump-autoload -o 更稳。
-
--no-dev：跳过phpunit、phpstan等开发依赖，体积减少 40% 以上 -
--no-scripts：避开post-install-cmd类脚本，防止因 vendor 路径异常或 Xdebug 导致中断 -
--no-autoloader：autoload 生成耗 CPU 且易因权限失败，留到最后统一处理更可控 - Xdebug 必须关——它会让依赖解析慢 5 倍以上；PHPStorm 默认开启，CI 环境里也常被忽略
真正容易被忽略的是：镜像配置只是起点，不是终点。一旦 composer install -vvv 显示请求域名仍是 packagist.org，其他所有优化都白搭——先盯死这一行，再谈提速。
