直接运行 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 即可全局切换为腾讯云镜像源，-g 表示全局配置，URL 末尾斜杠不可省略，执行后可用 composer config -g repo.packagist 验证。
composer config 怎么改全局镜像源
直接改全局配置最省事，后续所有项目都走腾讯云镜像，不用每个项目单独配。composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 这条命令就能搞定。
注意两点：一是 -g 参数必须带，表示修改全局配置（路径通常是 ~/.composer/config.json）；二是 URL 末尾的斜杠不能少，漏了会导致 404 或重定向失败。
- 执行后可以运行
composer config -g repo.packagist验证是否生效 - 如果之前用过阿里云或华为云镜像，这条命令会覆盖旧配置，不用手动删
- Windows 用户注意：PowerShell 里执行时，URL 建议用双引号包裹，避免解析异常
为什么 vendor/install 时还是走官方源
常见现象是改完镜像，composer install 却卡在 https://packagist.org，甚至报 Could not fetch https://packagist.org/packages.json。大概率是项目级配置覆盖了全局配置。
进项目根目录检查：cat composer.json | grep -A 5 "repositories"，如果里面写了 "packagist": false 或自定义了 repo.packagist，那全局设置就失效了。
- 临时解决：删掉
composer.json里的repositories段，再composer update --lock - 想保留私有包配置？把腾讯云镜像加进项目级 repositories，而不是关掉 packagist
- 别信“清缓存就能好”——
composer clear-cache对源地址没影响，只是删本地包文件
腾讯云镜像支持 HTTPS 和认证吗
支持 HTTPS，但不支持私有 token 认证。它的定位就是公开包的加速代理，不是私有仓库替代方案。
如果你的 composer.json 里有类似 "https://your-internal-repo.com" 这种私有源，腾讯云镜像不会转发或代理它；它只接管对 packagist.org 的请求。
- 遇到
401 Unauthorized错误？说明你在用需要 token 的私有源，和腾讯云镜像无关 - 国内服务器上用腾讯云镜像，平均下载速度比官方快 3–5 倍，但首次
composer update仍可能触发大量元数据拉取，别误判为卡死 - 镜像同步延迟约 5–10 分钟，刚发布的新版包别指望秒同步
换回官方源或切其他镜像怎么操作
换源不是删除重装，而是覆盖写入。要切回官方源，执行：composer config -g repo.packagist composer https://packagist.org。
想临时禁用镜像（比如调试网络问题），可以用 --no-plugins + --no-cache 组合，但更干脆的是直接加 -vvv 看实际请求地址，确认是不是真走了镜像。
- 别手动编辑
config.json文件——格式错一个逗号，composer就会拒绝读取整个配置 - 某些 CI 环境（如 GitHub Actions）默认没设全局镜像，得在 workflow 里显式执行 config 命令
- 腾讯云镜像域名偶尔会因 CDN 调度返回 503，这时快速切回官方源比等恢复更实际
镜像这事看着简单，真正卡住人的往往不是命令输错，而是项目配置、全局配置、插件行为三者混在一起，谁覆盖谁根本没感知。动手前先 composer config -g -l 和 composer config -l 对着看两行，比盲试十次都管用。
