已配置腾讯云Composer镜像源；需执行composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，URL必须以/结尾且不可写错字段名，生效后可通过composer show验证是否命中mirrors.cloud.tencent.com。
确认当前是否已用腾讯云镜像
执行 composer config -g repo.packagist，看输出的 url 是否为 https://mirrors.cloud.tencent.com/composer/。如果不是，说明还没生效；如果返回空或显示 https://packagist.org，那默认源还在跑——国内直连大概率卡在 Could not fetch 或超时。
全局配置腾讯云镜像（推荐）
运行这一条命令即可：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
注意这几点：
-
repo.packagist不能写成repo.packagist.org，后者会新建一个无效仓库名，Composer 不认 - URL 必须以
/结尾，否则 Composer 2.2+ 会报Invalid repository type - 不要用旧写法
repositories.packagist，Composer 2.5+ 已弃用 - 该命令实际修改的是
~/.composer/config.json，改完立刻全局生效
临时用腾讯云源（不改配置）
适合 CI/CD、调试或不想污染本地环境的场景，加 -r 参数即可：
composer install -r https://mirrors.cloud.tencent.com/composer/
或创建新项目时指定：
composer create-project laravel/laravel demo -r https://mirrors.cloud.tencent.com/composer/
关键限制：
-
-r只对当前命令有效，不会写入任何配置文件 - 不支持同时指定多个源，也不能和
config混用覆盖逻辑 - 若项目级
composer.json中有repositories字段，它仍会优先覆盖-r
验证是否真生效 & 常见失败点
先清缓存：composer clear-cache，再执行：
composer show laravel/framework 11.* --no-ansi | head -n 5
观察输出里是否出现 mirrors.cloud.tencent.com，或者响应明显变快（通常从几十秒降到 1–3 秒）。失败常见原因：
- DNS 解析失败：
ping mirrors.cloud.tencent.com看通不通，不通就换阿里云源https://mirrors.aliyun.com/composer/ - 项目级
composer.json里写了repositories，它会盖掉全局设置，得手动删或改掉 - 用了已停用的旧镜像如
packagist.phpcomposer.com（2025 年底起基本不可用）
镜像不是一劳永逸的事——腾讯云源偶尔也会因 CDN 调度或区域节点问题短暂不可达，建议手边备一个阿里云源，切起来就一条命令。
