腾讯云服务器配腾讯云composer镜像的正确命令是composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，需严格满足键名、type值、url末尾斜杠三要素，缺一即静默失效；验证应输出完整json，且create-project须用--repository-url参数才生效。
腾讯云服务器上配腾讯云 Composer 镜像，不是“官方镜像”
腾讯云 https://mirrors.cloud.tencent.com/composer/ 是腾讯云维护的 Packagist 镜像，不是 Composer 官方提供的——Composer 官方源只有 https://packagist.org。所谓“官方镜像”是误称，实际指“腾讯云提供的、针对国内优化的 Composer 镜像”。在腾讯云服务器上用它，优势明显：内网访问快、DNS 解析稳定、无跨运营商抖动。
composer config -g repo.packagist 命令必须写对三要素
在腾讯云服务器上执行全局配置时，常见失败不是网络问题，而是命令写错。以下三个点缺一不可：
-
repo.packagist是固定键名，不能写成repos.packagist（多一个s就静默失效） -
composer是type字段值，必须显式写出，不能省略 - URL 必须是 HTTPS 且末尾带
/，即https://mirrors.cloud.tencent.com/composer/，少斜杠或用 HTTP 会触发Invalid repository type错误
正确命令：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
验证是否生效：
composer config -g repo.packagist
输出应为：{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}
为什么 composer create-project 还是慢？得加 --repository-url
composer create-project 默认不读取你配的全局镜像，它会先直连 packagist.org 拉元数据，再下载 ZIP 包——而 ZIP 包地址仍指向 GitHub/GitLab，不受镜像控制。结果就是“换了镜像，但项目初始化还是卡”。
解决方法只有一种：显式指定镜像源
composer create-project laravel/laravel myapp --repository-url=https://mirrors.cloud.tencent.com/composer/
注意：-r 参数（--repository）在此命令中无效，必须用 --repository-url。
同步延迟时别急着换源，composer update 会自动 fallback
腾讯云镜像标称 24 小时同步，实际多数包几分钟内就可查到，但刚发布不到 1 小时的包（尤其是 dev 分支）可能还没同步。此时执行 composer require vendor/package 报 Could not find package，不代表镜像坏了。
Composer 2.2+ 默认启用自动 fallback：当镜像返回 404 或 503，会自动切回 packagist.org 查一次。这个机制不能关，也不该关——手动删掉镜像配置或设 repos.packagist false 反而会让缺失包直接报错，失去兜底能力。
判断是不是真缺包：
- 打开
https://mirrors.cloud.tencent.com/composer/页面，看底部「最后更新时间」 - 运行
composer show vendor/package --no-ansi | head -n 5，观察请求 URL 是否含mirrors.cloud.tencent.com - 仍失败？再试
composer update --repository-url=https://packagist.org直连确认
真正容易被忽略的，是 fallback 机制的存在感太低——它不打印提示，只默默重试。很多人在镜像未同步时手动切源、清缓存、重装 Composer，其实纯属白忙。
