composer config -g repo.packagist 不生效是因为必须严格满足三个条件：键名只能是 repo.packagist，type 值必须显式写为 composer，URL 必须是 HTTPS 且末尾带 /；否则配置无效且无提示。
composer config -g repo.packagist 命令为什么总不生效
它根本不会报错，但你执行完 composer config -g repo.packagist https://mirrors.aliyun.com/composer/，composer install 还是卡在 Downloading，甚至日志里继续出现 packagist.org —— 问题不在网络，而在命令本身漏了三个硬性条件：
-
repo.packagist是唯一合法键名：写成repos.packagist、repository.packagist或packagist.org全部无效 - 中间必须显式写
composer，它是 type 值，不是可选参数——漏掉就等于没配 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404，且无提示
验证是否真写进去了？别信“命令没报错”，直接运行 composer config -g repo.packagist。输出必须是完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null 或 Key does not exist，说明根本没写成功。
项目里有 repositories 字段，全局镜像还管用吗
完全不管用。Composer 的仓库优先级是硬编码的：项目 composer.json > 全局 ~/.composer/config.json > 默认源。只要项目根目录的 composer.json 里定义了 "repositories"（哪怕只写了 [] 或 {"packagist.org": false}），全局配置就会被跳过，且不报任何警告。
常见误操作：
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）会全量替换整个repositories字段，把你已有的私有 Git 源（如"my-private": {"type": "vcs", ...}）直接清空 - 哪怕
"repositories": {}这种空对象，也会触发“禁用默认源”，全局镜像彻底失效 - CI/CD 或宝塔面板常用
www用户运行命令，而composer config -g默认写的是当前 shell 用户的配置，权限链断了
安全做法：手动编辑 composer.json，确保 repositories 是数组，首位放 {"packagist.org": false}，第二位才是镜像源，并保留其他自定义源。
换镜像后 composer install 报 hash 不匹配
这不是网络或镜像问题，而是旧 composer.lock 文件里记录的包哈希和 dist URL 来自官方源。切换镜像后，Composer 仍按原路径去阿里云找 zip 包——但镜像服务的内部路径映射与 packagist.org 不同，校验必然失败。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
必须做两件事：
- 删掉项目里的
vendor/目录 - 删掉
composer.lock文件
再执行 composer install（不是 update），让 Composer 重新解析依赖、生成新 lock 文件。如果只跑 composer update，它会复用旧 lock 里的 URL 和 hash，照样失败。
宝塔或 Docker 环境下镜像配了还是卡住
别急着换源，先确认 PHP CLI 环境是否能跑起来。宝塔默认禁用 putenv、proc_open、pcntl_signal 这三个函数，Composer 启动即崩溃，根本走不到镜像环节。
操作步骤：
- 进宝塔「PHP 管理」→ 选对应版本 → 「禁用函数」页签 → 删除
putenv、proc_open、pcntl_signal - 终端执行软链接（以 PHP 8.0 为例）：
ln -sf /www/server/php/80/bin/php /usr/local/bin/php - 验证：
php -v和php -m | grep -E "openssl|tokenizer"，确保模块加载正常
做完再配镜像，否则换源只是给一个瘫痪的环境加速报错。多用户环境（如宝塔、Docker）下，-g 配的是当前 shell 用户的配置，而 Web 服务可能以 www 用户运行，此时必须切换用户执行：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
