唯一可靠方式是运行composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，因composer 2.5+仅识别该固定键名、强制要求type为composer且url必须以/结尾，缺一即静默回退官方源。
直接生效的唯一方式是运行 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，其他写法基本都失效——尤其别漏掉 URL 末尾的 /。
为什么 composer config -g repo.packagist 是唯一可靠命令
Composer 2.5+ 之后只认 repo.packagist 这个固定键名，repos.packagist、repositories.packagist、repo.packagist.org 全部无效。type 值必须是 composer（不能省略），URL 必须以 / 结尾，否则请求会拼出 /p2/ 或 /packages.json 这类错误路径，直接返回 404。
常见错误现象：
-
composer config -g repo.packagist输出为空或报错Key "repo.packagist" does not exist -
composer diagnose仍显示Repo packagist.org is default -
composer install日志里出现Downloading https://packagist.org/packages.json
ThinkPHP 项目里最容易踩的覆盖坑
只要项目根目录下 composer.json 里有 "repositories" 字段（哪怕只是空数组 []），全局镜像就完全失效——Composer 的优先级永远是：项目 > 全局 > 默认源。
检查是否被覆盖的方法：
- 进项目根目录，运行
composer config repo.packagist；有输出说明项目级已设，覆盖了全局 - 运行
composer config --list | grep repositories，看是否出现项目级配置项 - 打开
composer.json，搜"repositories"，如果存在且没显式禁用 packagist，就删掉或改成："packagist": false
配完不生效？缓存和权限才是真瓶颈
即使命令执行成功，composer install 仍慢或连官方源，大概率是本地元数据缓存没清，或配置写到了错误用户目录。
必须做的两件事：
- 运行
composer clear-cache—— 否则 Composer 会继续从旧缓存读packages.json和p2/索引 - 确认当前终端用户和 Composer 实际运行用户一致：Windows 要重启命令行，Linux/macOS 检查是否误用了
sudo，Docker 或 CI 环境里得确保构建用户家目录下有正确配置
验证是否真正走镜像：运行 composer require monolog/monolog -vvv，日志里看到 Downloading https://mirrors.cloud.tencent.com/composer/ 才算落地。
腾讯云镜像的硬限制你得知道
它不是全量实时同步，更新延迟约 24 小时。新发布的 ThinkPHP 插件或 dev 分支包，可能当天在镜像里查不到。
遇到 Could not find package xxx 时：
- 先
composer clear-cache，再composer show xxx确认是否真缺失 - 临时切回官方源验证：
composer config -g repo.packagist composer https://packagist.org - 别在 ThinkPHP 项目里留
"@dev"或"prefer-stable": false，这类配置会强制触发大量远程元数据查询，解析阶段就卡住十几秒
镜像地址末尾那个 /，不是风格问题，是协议路径匹配的生死线——少一个字符，整个换源就白忙活。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
