腾讯云镜像不能保证十倍提速，仅解决卡死超时问题；生效需严格满足三点：repo.packagist（非repos）、type值为composer、url为https且末尾带/；项目级repositories会完全覆盖全局配置，验证用composer config -l | grep repositories.packagist。
不能只靠换腾讯云镜像就让 Composer 执行速度提升十倍。实际提速取决于网络环境、包体积、本地缓存状态和是否被项目配置覆盖——多数情况下，它能解决“卡死”“超时”问题，但“十倍”是特定场景下的峰值表现，不是稳定常态。
composer config -g repo.packagist 命令必须写对三个硬伤点
90% 的“换了不生效”都卡在这三处，且 Composer 不报错，只默默走回官方源：
-
repo.packagist不能拼成repos.packagist（多一个 s 就彻底失效） - 中间那个
composer是type字段值，必须显式写出：正确是composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，漏掉就白配 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.cloud.tencent.com/composer/✅，https://mirrors.cloud.tencent.com/composer❌（缺斜杠在 Composer 2.2+ 会报Invalid repository type）
为什么 composer install 还是走 packagist.org？检查项目级覆盖
全局配置会被项目根目录下的 composer.json 完全覆盖。只要里面写了 repositories 字段，哪怕只有一行，repo.packagist 就失效。
- 进项目目录执行：
grep -A 5 "repositories" composer.json，看是否含"packagist.org": { "type": "composer", "url": "https://packagist.org" }或"packagist": false - 验证当前实际生效源：
composer config -l | grep repositories.packagist，输出为空或仍是https://packagist.org就说明被盖掉了 - 临时修复：删掉
composer.json里的repositories段，再运行composer update --lock - 想保留私有仓库？手动把腾讯云镜像加进项目级
repositories，而不是关掉packagist
临时切源不改配置：-r 参数只对当次命令有效
适合 CI 构建、调试网络、对比镜像速度，不污染本地环境：
- 用法：
composer install -r https://mirrors.cloud.tencent.com/composer/ - 它会忽略所有已配置的仓库（包括项目级），强制从指定地址拉元数据
- 限制很明确：
composer create-project不支持-r；也不能混用--repository-url等其他源参数 - 想在
create-project中用镜像？先composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，再执行
南方用户优先选腾讯云，但别忽略同步延迟和 HTTPS 证书问题
腾讯云镜像在华南地区延迟更低，云服务器内网访问可能有额外加速，但它同步频率略低于阿里云——新发布的包可能晚 1–3 分钟才可见。
- 遇到
Could not find package xxx，先确认是不是刚发布的新版本，再查镜像状态页（如 https://www.php.cn/link/e59c62a0e3bb247c17c1b7cccb82dc02） -
SSL certificate problem: unable to get local issuer certificate：Windows 用户需在php.ini中启用curl.cainfo指向有效的cacert.pem -
Could not resolve host: mirrors.cloud.tencent.com：可能是公司 DNS 屏蔽，可尝试用 IP 直连（如118.31.67.52），或换阿里云镜像测试
真正卡住的地方，往往不是镜像选错，而是没意识到项目级配置会完全屏蔽全局设置，或者 URL 少了个斜杠却以为配成功了。验证永远比重试更省时间。
