必须换国内镜像源；执行composer config -g repo.packagist确认url为https://mirrors.aliyun.com/composer/等国内地址，为空或仍显示packagist.org则未生效，旧版需用repos.packagist，项目级repositories会覆盖全局，-vvv日志验证下载域名。
确认当前用的是哪个源
直接运行：composer config -g repo.packagist
输出必须是完整 HTTPS 地址，比如 https://mirrors.aliyun.com/composer/。如果显示 null、空值，或仍是 https://packagist.org，说明没生效。
常见错误：
• 写成 repos.packagist（多一个 s），Composer 会静默忽略
• 旧版 Composer 1.x 不识别 repo.packagist，得用 composer config -g repos.packagist '{"type":"composer","url":"..."}'
• URL 末尾漏了 /，部分版本拼接出错导致 404
全局切阿里云镜像（推荐）
执行这条命令即可立即生效，所有 ThinkPHP 项目都走这个源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意：
• 必须带上 composer 这个 type 值，不能省略
• 阿里云同步及时、CDN 覆盖广，比已停更的 Laravel China 镜像（2025 年底下线）更可靠
• 设完立刻清缓存：composer clear-cache，否则旧元数据还在，仍会尝试从原地址拉取
验证是否真走国内镜像
光看 config 输出不够，要亲眼看到请求发到了镜像域名：composer install -vvv 2>&1 | grep "Downloading"
日志里必须出现类似 mirrors.aliyun.com 或 mirrors.tuna.tsinghua.edu.cn 的路径才算真正生效。如果还看到 packagist.org，说明 fallback 了，配置被覆盖或未生效。
排查要点：
• 项目级 composer.json 中定义了 repositories，会覆盖全局配置
• 可用 composer config --list 和 composer config --list --global 对比，确认实际生效的是哪个
• 临时绕过所有自定义源测试：composer install --no-plugins --repository=https://packagist.org，如果变快，说明本地 repositories 配置有问题
其他可用镜像源（备用）
如果阿里云偶尔不稳定，可快速切换为以下任一源：
• 清华大学镜像（高校网络友好）：composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/
• 华为云镜像（企业环境稳定）：composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/
• 腾讯云镜像：composer config -g repos.packagist composer https://mirrors.cloud.tencent.com/composer/
恢复官方源只需一条命令：composer config -g --unset repos.packagist
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
