Composer国内镜像配置必须满足三要素：键名repo.packagist（单数）、type值显式为composer、URL以/结尾，缺一即静默失效；验证需用composer config -g repo.packagist检查输出，并通过composer require -vvv确认实际请求域名。
国内用 Composer 装 PHP 包，不配镜像基本装不完——不是慢，是直接卡死在 Downloading、403 或超时。配对、配全、配准，三者缺一不可。
composer config -g repo.packagist 命令总不生效？检查这三处硬伤
命令写错不会报错，但会静默失效，查 composer config -g repo.packagist 输出为空或 null 就说明失败了。常见错误就三个：
- 键名写成
repos.packagist（多一个s），Composer 完全忽略 - 漏掉
composer这个 type 值：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，少中间那个composer就 fallback 到官方源 - URL 末尾没斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌——少斜杠会导致拼出/composerpackages.json这种非法路径，404 后直接退到packagist.org
全局配置 vs 项目级配置：哪个更可靠？
全局配置看似省事，但在宝塔、CI、Docker 或多用户环境里极易失效——因为 composer config -g 写进的是当前用户的 ~/.composer/config.json，而实际跑命令的可能是 www、runner 或容器内非 root 用户。
项目级配置反而更稳：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 它会自动往
composer.json的repositories字段安全追加，不覆盖已有私有源 -
composer.json可提交 Git，新人拉完代码就能用，CI 构建也无需额外处理权限或路径 - 注意：如果原
composer.json里"repositories": []是数组格式，该命令会失败；得先手动改成"repositories": {}（空对象）再执行
换镜像后还是卡在 “Resolving dependencies”？那和镜像无关
镜像只加速下载环节，Resolving dependencies 卡住，100% 是本地解析问题，和网络、镜像源完全无关：
-
composer.json里写了太宽的 PHP 版本约束，比如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"，求解器暴力穷举组合 - 启用了
"minimum-stability": "dev"，候选版本数爆炸 - 删了
composer.lock后直接install，实际触发了update流程 - Xdebug 开着：会让依赖解析慢 5–10 倍，临时禁用试试：
php -d xdebug.mode=off $(which composer) install - PHP 内存不足：默认 128M 不够，加
COMPOSER_MEMORY_LIMIT=-1再试
验证镜像是否真正在用？别只看 config 输出
composer config -g repo.packagist 只告诉你“写了什么”，不是“用了什么”。最靠谱的验证方式是跑一次真实请求：
- 先清缓存：
composer clear-cache - 执行带详细日志的命令：
composer require monolog/monolog -vvv - 在输出里搜索
Downloading，确认出现的是：Downloading https://mirrors.aliyun.com/composer/packages.json - 如果看到
https://packagist.org/packages.json或https://repo.packagist.org/packages.json，说明被项目级repositories覆盖了，或者composer.json里写了"packagist.org": false这类彻底关源的配置
镜像配置本身不复杂，但错一个字符、少一个斜杠、漏一个参数，就会彻底失效——而且不报错。真正容易被忽略的，是验证时只看配置命令输出，却不去盯 -vvv 日志里的实际请求域名。
