Composer全局换源需用repositories.packagist.org键名、指定type: "composer"、URL末尾加斜杠、加-g参数并执行composer clear-cache，否则配置无效。
直接换阿里云或腾讯云镜像源，能明显加快依赖下载速度，避免超时失败；但 90% 的人配不成功，不是网络问题，是命令写错了。
composer config -g repo.packagist 命令为什么没生效
执行后 composer install 还卡在 Loading composer repositories，大概率是键名、类型、URL 三处之一出错：
-
repo.packagist是 Composer 1.x 写法，2.2+ 推荐用repositories.packagist.org（旧键名在部分新版中会被静默忽略） - 漏掉
composer类型声明：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，少写composer就 fallback 回官方源 - URL 末尾缺斜杠：
https://mirrors.aliyun.com/composer（无斜杠）会返回 404，必须是https://mirrors.aliyun.com/composer/ - 没加
-g：命令变成项目级配置，只影响当前目录，换个项目就失效 - 未清缓存：
composer clear-cache必须执行，否则元数据仍从旧源加载
全局换源推荐命令（兼容 Composer 2.2+）
用 repositories.packagist.org 键名，避免版本兼容问题，阿里云和腾讯云都稳定：
- 设阿里云源：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - 设腾讯云源（fallback 更友好，找不到包时自动试官方源）：
composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}' - 验证是否写入：
composer config -g repositories.packagist.org，输出应为完整 JSON 对象，不是空或报错
项目级配置更安全，适合团队协作
全局配置看着省事，但一旦参与开源项目或 CI 流水线，容易因镜像差异导致 hash 不一致、依赖解析失败。项目级配置写进 composer.json，所有人行为一致：
- 命令追加（不覆盖已有
repositories）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：无-g） - 手动编辑
composer.json时，确保格式合法："repositories"是数组，不是对象；"packagist"不能写成"aliyun"或其他别名 - 已有
"repositories"字段？别手动删改——用命令追加，否则可能误删私有包源 - 加了
"packagist": false？必须自己补全官方源，否则基础包都拉不到（不推荐）
换源后仍然卡在 Resolving dependencies 怎么办
镜像只加速下载，不解决依赖解析慢的问题。如果 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，和镜像无关：
- 检查
composer.json中的 PHP 版本约束是否太宽，比如"php": "^7.4 || ^8.0"—— 收窄到具体小版本可大幅提速 - 大量
dev-包未锁定版本，或require-dev塞了太多工具链，也会拖慢解析 - 首次换源后若报
hash mismatch，删掉vendor和composer.lock重来即可 -
composer update卡住时，加-vvv看详细日志，确认卡点是否真在解析阶段
最常被忽略的是：换源后必须 composer clear-cache，否则 Composer 仍用旧元数据；另外，宝塔等面板环境需先解除 putenv、proc_open 等禁用函数，否则 composer 启动即崩溃。
