全局切换腾讯云镜像源只需运行 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，末尾斜杠不可省略；生效前必须执行 composer clear-cache，并用 composer config -g repo.packagist 验证URL是否正确输出。
怎么全局切换到腾讯云镜像源
直接运行一条命令就能永久生效，所有后续 composer install 或 composer update 都会走腾讯云节点：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/- 注意 URL 末尾必须带
/composer/，写成/composer或漏掉斜杠会失败 - 执行后无需重启终端，也无需改任何配置文件，Composer 自动识别
为什么换源后没变快？常见失效原因
换完不生效，90% 是因为缓存没清或验证方式不对：
- 必须运行
composer clear-cache—— 否则 Composer 还在用旧的元数据缓存 - 验证是否生效，别只看命令有没有报错，要运行：
composer config -g repo.packagist，输出里应明确出现"url": "https://mirrors.cloud.tencent.com/composer/" - 如果执行
composer show laravel/framework --no-ansi | head -n 3，响应中仍显示packagist.org或超时，说明根本没走新源，大概率是 DNS 解析失败（可试ping mirrors.cloud.tencent.com）
临时用腾讯云源，不改全局配置
适合想测试效果、或只在某个项目里用，又不想影响其他项目的场景：
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 这条命令会往当前项目的
composer.json里写入repositories字段，只对这个项目生效 - 如果之后想删掉，运行：
composer config --unset repos.packagist（不加-g） - 注意：这种方式和全局配置互不干扰，但若同时存在，项目级配置优先级更高
换源失败时怎么快速回退
误操作或网络不通导致依赖拉不下来，最稳妥的退出路径就一条命令：
-
composer config -g --unset repos.packagist—— 立刻移除全局镜像设置，Composer 自动回落到默认的https://packagist.org - 不需要手动编辑
~/.composer/config.json，除非你改过其他自定义项 - 如果连这条命令都卡住（比如 DNS 全挂），可先临时加
--repository=https://packagist.org强制指定源再执行
腾讯云镜像本身没问题，但它的可用性高度依赖本地网络环境——比如某些教育网或企业防火墙会拦截 mirrors.cloud.tencent.com，这时候切阿里云源（https://mirrors.aliyun.com/composer/）往往更稳。换源不是一劳永逸，而是要配合 clear-cache 和实际命令响应来交叉验证。