唯一正确写法是composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/，因composer 2.5+仅识别固定键名repo.packagist、type值必须为composer且url末尾斜杠不可省略。
腾讯云镜像能用，但配置错一个字符就白忙活——最常卡在 repo.packagist 键名、composer 类型值、末尾斜杠 / 三处。
为什么 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 才是唯一正确写法
不是 repos.packagist，不是 repo.packagist.org，也不是 repositories.packagist。Composer 2.5+ 只认 repo.packagist 这个固定键名，且必须紧跟着 composer（type 值），不能省略。URL 末尾的 / 也必须保留，否则部分版本会返回 404 或报 Invalid repository type。
常见错误现象：
- 执行后
composer diagnose仍显示Repo packagist.org is default -
composer config -g repo.packagist输出为空或格式异常 -
composer install依然慢，抓包看到请求发向packagist.org
验证是否写入成功：
composer config -g repo.packagist
正确输出应为：
{"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}
配置生效了，但 composer install 还是连不上？先清缓存、再查覆盖
Composer 不会自动丢弃旧元数据，即使你改了配置，它仍可能从本地缓存里读取过期的 packages.json 和 p2/ 索引，导致行为和配置不一致。
必须执行：
-
composer clear-cache—— 强制刷新所有本地元数据 -
composer config repos.packagist—— 进项目根目录运行，检查是否有项目级配置覆盖全局设置（有输出即被覆盖） - 若项目级存在
"repositories"字段且显式写了"packagist.org"，镜像完全不会启用
临时绕过所有配置验证镜像可用性：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer show laravel/framework 11.* -r https://mirrors.cloud.tencent.com/composer/ --no-ansi | head -n 5
观察输出中是否含 mirrors.cloud.tencent.com 或响应明显变快。
腾讯云镜像连不通？别硬扛，换源或直连 IP 更实际
部分地区（教育网、某些企业防火墙）会拦截 mirrors.cloud.tencent.com：DNS 解析失败、HTTPS 握手超时、甚至返回空响应。这不是配置问题，是网络策略问题。
快速排查步骤：
-
ping mirrors.cloud.tencent.com—— 不通就别继续 -
curl -I https://mirrors.cloud.tencent.com/composer/—— 看是否返回200 OK - 换阿里云源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 若公司 DNS 屏蔽域名，可尝试用 IP +
/etc/hosts绑定（如118.31.67.52 mirrors.aliyun.com）
CI 或单次调试时，推荐直接用 -r 参数，干净利落：
composer install -r https://mirrors.aliyun.com/composer/
恢复官方源或彻底清理配置的可靠方式
想退回到默认源，不要手动删 ~/.composer/config.json —— 容易误删其他配置。用命令更安全：
- 移除全局镜像：
composer config -g --unset repos.packagist - 若该命令卡住（比如 DNS 全挂），强制指定源再 unset：
composer config -g --repository=https://packagist.org --unset repos.packagist - 项目级配置清除：
composer config --unset repos.packagist（不加-g，在项目内运行）
注意：--unset 操作不可逆，但 Composer 会自动 fallback 到 https://packagist.org，无需额外操作。
真正容易被忽略的是缓存和优先级：哪怕你把命令敲得一字不差，clear-cache 没执行，或者项目里有 repositories，镜像就等于没配。
