Composer国内直连packagist.org慢且易失败，切换腾讯云镜像源可显著提速；执行composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/完成全局配置，注意URL须以/结尾且勿用旧语法。
Composer 默认从 packagist.org 拉包，国内直连慢、超时、404 频发；切换腾讯云镜像源能显著提速，且无需科学上网。
确认当前全局源是否为腾讯云
执行 composer config -g repo.packagist 查看当前全局配置。若返回 {"type": "composer", "url": "https://packagist.org"} 或为空，则未生效；若已显示 https://mirrors.cloud.tencent.com/composer/，说明已配置成功。
注意：composer config -g 仅显示全局配置，项目级（composer.json 同级）的 composer.json 中若含 repositories 字段，会覆盖全局设置。
全局替换为腾讯云镜像源（推荐）
运行以下命令一次性完成全局替换：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
这条命令等价于在 ~/.composer/config.json 中写入：
{
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.cloud.tencent.com/composer/"
}
}
}- 务必使用
composer config -g repo.packagist（不是repo.packagist.org），否则会新建一个无效仓库名 - URL 必须以
/结尾，否则部分版本 Composer（如 2.2+）会报Invalid repository type - 不建议用
composer config -g repositories.packagist，旧写法在 Composer 2.5+ 已弃用
临时使用腾讯云源（单次命令）
某些 CI 场景或调试时不想改全局配置，可用 -r 参数指定源：
composer install -r https://mirrors.cloud.tencent.com/composer/
或针对某条命令临时生效：
composer create-project laravel/laravel demo -r https://mirrors.cloud.tencent.com/composer/
注意：-r 仅对当前命令有效，不会写入任何配置文件；也不支持同时指定多个源。
验证是否生效 & 常见失败原因
执行 composer clear-cache 清缓存后，运行 composer show laravel/framework 11.* --no-ansi | head -n 5，观察输出中是否出现腾讯云域名（如 mirrors.cloud.tencent.com）或响应明显变快。
常见失败点：
-
Could not fetch https://mirrors.cloud.tencent.com/composer/p2/...：通常是 DNS 解析失败，可尝试ping mirrors.cloud.tencent.com或换用https://packagist.phpcomposer.com（已停用）或阿里云源作备选 - HTTPS 报错（如
SSL certificate problem）：检查系统 CA 证书是否过期，或临时加-k（不推荐生产环境） - 执行后仍走原源：确认没在项目根目录存在
composer.json的repositories覆盖了全局配置
腾讯云镜像本身不代理私有包，如果你的项目依赖了 GitHub 私有库或自建 Satis 源，这些仍需单独配置，腾讯云源只加速 packagist.org 公共包。
