Composer中文镜像腾讯云源切换的图文教程-composer-PHP中文网

直接执行 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 才能正确切换腾讯云镜像源，漏掉 -g、键名误写为 repos.packagist、url 末尾缺 / 或缺少中间 composer 类型参数，均会导致静默失效；验证需检查 composer config -g repo.packagist 输出是否为完整 json，且含 "type": "composer" 和正确 url。

composer中文镜像腾讯云源切换的图文教程

直接执行 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 就能切腾讯云镜像源，但 90% 的人卡在“命令看似成功、实际没生效”——根本原因是漏掉 -g、键名写错、URL 缺末尾 /，三者任一出错都会静默回退到 packagist.org。

为什么 `composer config -g repo.packagist` 总不生效

这不是网络问题，是配置没写进 Composer 认得的位置。Composer 2.2+ 对键名和结构更敏感，常见失效原因：

repo.packagist 写成 repos.packagist（复数）：配置存进无效字段，composer config -g repo.packagist 查出来为空
漏掉 composer 类型参数：命令必须是 composer config -g repo.packagist composer https://...，少写中间那个 composer 就 fallback 到官方源
URL 末尾没加 /：比如 https://mirrors.cloud.tencent.com/composer → 请求时拼成 /composerpackages.json，直接 404
没加 -g：命令变成项目级配置，只改当前目录的 composer.json，换个项目就失效

验证是否真正生效的唯一可靠方法

别看命令有没有报错，要看它到底写了什么：

腾讯云跨账号资源迁移

腾讯云跨账号资源迁移工具，支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B，通过CCN云联网实现跨账号网络互通，提供自动扫描、配置生成、Terraform部署功能。

下载

运行 composer config -g repo.packagist，输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}
如果输出 null、空行、或 {"url": "https://packagist.org"}，说明没配成功
再跑一次 composer clear-cache，否则旧元数据缓存还在，composer install 仍走老路径
验证下载行为：执行 composer show laravel/framework --no-ansi | head -n 3，观察 URL 是否含 mirrors.cloud.tencent.com

项目级配置比全局更稳妥的场景

团队协作或 CI 环境里，全局配置容易被权限、用户或脚本覆盖（比如宝塔面板用 www 用户执行，但 -g 写的是 root 的配置）。这时用项目级更可控：

进项目根目录，去掉 -g 执行：composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
它会自动合并进 composer.json 的 "repositories" 字段，key 固定为 "packagist"
前提是原 composer.json 中 "repositories" 是对象（如 "repositories": {}），不是数组；如果是数组，命令会失败，需先手动转成对象
提交 Git 后，所有协作者和 CI 都走同一镜像，composer.lock hash 不会因源差异而变

腾讯云 vs 阿里云 vs 华为云地址细节差异

不能套用模板，路径格式完全不同，尤其华为云：

腾讯云：https://mirrors.cloud.tencent.com/composer/（结尾带 /，路径干净）
阿里云：https://mirrors.aliyun.com/composer/（同上，全国骨干网覆盖均衡）
华为云：https://mirrors.huaweicloud.com/repository/php/composer/（注意中间有 /repository/php/，不是 /composer/）
清华旧镜像 https://packagist.phpcomposer.com 已下线，继续用会报 Could not resolve host