唯一正确写法是composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，键名必须为repo.packagist（不可加s）、type值composer不可省略、URL末尾斜杠/不可缺失，三者缺一即静默失效；配置后须执行composer clear-cache并验证composer config -g repo.packagist输出完整JSON，再通过composer show -r或抓包确认实际请求域名。
composer config -g repo.packagist 命令必须严格按格式执行
腾讯云轻量服务器上配镜像，composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 是唯一能生效的写法。错一个字符——比如把 repo.packagist 写成 repos.packagist、漏掉 composer 类型值、URL 少了末尾的 /——就会静默失败，不报错也不生效。
常见现象：composer diagnose 仍提示 Repo packagist.org is default，或 composer config -g repo.packagist 输出为空。
-
repo.packagist是固定键名，不能加s，不能带.org -
composer是必须显式写出的 type 值，不是可选参数 -
https://mirrors.cloud.tencent.com/composer/末尾斜杠/缺一不可，否则部分 Composer 版本会返回Invalid repository type
配置后依然走 packagist.org？先查三处干扰源
轻量服务器常因环境残留导致镜像不生效，不是镜像本身问题，而是本地配置被覆盖或缓存未刷新。
腾讯云跨账号资源迁移
下载
腾讯云跨账号资源迁移工具，支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B，通过CCN云联网实现跨账号网络互通，提供自动扫描、配置生成、Terraform部署功能。
- 执行
composer config repos.packagist（不加-g），进项目根目录运行——如果有输出，说明项目级composer.json中的repositories字段覆盖了全局设置 - 检查代理：Linux/macOS 运行
echo $http_proxy，Windows 运行set http_proxy；有值就用composer config -g --unset http-proxy清掉 - 强制清缓存：
composer clear-cache—— 否则 Composer 仍可能读取旧的p2/索引，行为与新配置不一致
验证镜像是否真生效的实操方法
别只看 composer config -g repo.packagist 输出 JSON，要观察实际网络行为。
- 正确输出应为：
{"type":"composer","url":"https://mirrors.cloud.tencent.com/composer/"} - 临时绕过所有配置验证可用性：
composer show laravel/framework 11.* -r https://mirrors.cloud.tencent.com/composer/ --no-ansi | head -n 5，观察响应中是否含mirrors.cloud.tencent.com或耗时明显变短 - 抓包确认：
strace -e trace=connect,sendto,recvfrom composer install -vvv 2>&1 | grep -i "mirrors\|packagist"（Linux），看实际请求域名
腾讯云镜像连不通？别死磕，换源或直连更实际
轻量服务器某些地区（如教育网出口、企业防火墙策略）会拦截 mirrors.cloud.tencent.com，表现为 DNS 解析失败、HTTPS 握手超时或空响应——这不是你配错了，是网络策略问题。
- 快速排查：
ping mirrors.cloud.tencent.com和curl -I https://mirrors.cloud.tencent.com/composer/，任一失败就别继续试配置 - 换阿里云源更稳：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（更新频率 96 秒，比腾讯云的 24 小时更快） - 如果必须用腾讯云且 DNS 不通，可临时改 hosts：
echo "110.242.68.10 mirrors.cloud.tencent.com" | sudo tee -a /etc/hosts（IP 来自公开探测，非固定，需自行验证）
镜像配置本身很简单，但轻量服务器的网络环境和残留配置才是真正的变量。每次改完都得清缓存、查覆盖、验真实请求，少一步就白配。
