切换镜像源后 composer install 仍不走腾讯云，主要因项目级配置（如 composer.json 中 repositories 字段）优先级高于全局配置，或显式声明 packagist.org 地址所致；需检查并清理项目配置、确认全局设置、清除缓存，并正确执行 composer config 命令。
为什么切换镜像源后 composer install 仍不走腾讯云？
常见原因是只改了全局配置，但项目目录下存在 composer.json 或 composer.lock，而 Composer 会优先读取项目级配置（如 repositories 字段），覆盖全局镜像设置。另外，某些项目显式声明了 packagist.org 的 URL，也会绕过镜像。
实操建议：
- 先运行
composer config -g repos.packagist确认全局镜像是否已设为腾讯云地址（应返回{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}） - 检查项目根目录的
composer.json，删掉或注释掉类似"repositories": [{"type": "composer", "url": "https://packagist.org"}]的手动配置 - 执行
composer clear-cache清除本地缓存，避免旧元数据干扰
用 composer config 一次性切到腾讯云镜像的正确命令
全局切换（推荐，影响所有项目）：
composer config -g repos.packagist composer https://mirrors.cloud.tencent.com/composer/
项目级切换（仅当前目录生效，适合多源混用场景）：
composer config repos.packagist composer https://mirrors.cloud.tencent.com/composer/
注意点：
- 命令中
repos.packagist是固定键名，不能写成repo.packagist或repositories.packagist -
composer是 type 值，必须小写、不可省略；腾讯云镜像 URL 结尾的/建议保留，否则部分版本会报 404 - 如果提示
Could not find package ...，大概率是镜像同步有延迟（通常 -vvv 看实际请求地址是否已变
验证镜像是否生效的三个快速方法
别只看命令是否成功，要确认网络请求真发到了腾讯云：
- 执行
composer diagnose，末尾会显示Repo: https://mirrors.cloud.tencent.com/composer/ - 运行
composer show -p | head -n 3，观察第一行是否含mirrors.cloud.tencent.com（Composer v2.2+ 支持） - 最可靠：加
-vvv跑一次composer update --dry-run，搜索日志里的GET https://mirrors.cloud.tencent.com/...
切换后遇到 Package not found 怎么办？
腾讯云镜像不是实时全量同步，尤其对新发布包或私有仓库，可能滞后几分钟到几小时。这不是配置错误，而是镜像机制本身决定的。
应急方案：
- 临时退回到官方源：执行
composer config -g repos.packagist composer https://packagist.org - 只对特定包禁用镜像（如公司私有包）：在
composer.json中单独配置"repositories": [{"type": "composer", "url": "https://your-private-repo.com"}]，其余走腾讯云 - 确认包名拼写和版本约束是否合理——镜像不会改变语义，但会暴露原本被缓存掩盖的拼写错误
腾讯云镜像的同步策略是按需拉取 + 定时补全，所以首次安装冷门包时稍慢属正常现象。真正该警惕的是所有包都 404，那基本是 URL 拼错或网络拦截问题。
