国内直连 packagist.org 因 dns 污染与 tls 阻塞基本不可用，必须配置带 type="composer" 的镜像源并清缓存，且项目级 repositories 会无条件覆盖全局配置。
国内直连 packagist.org 基本不可用，不配镜像源的 composer install 不是慢，是大概率卡死在 “Resolving dependencies” 或直接超时失败——这不是网络问题，是 DNS 污染 + TLS 握手阻塞导致的刚性限制。
为什么 composer config -g repo.packagist 必须带 composer 类型值
这个配置项不是简单设个 URL 就完事。键名 repo.packagist 对应的是一个仓库定义对象，必须显式声明 "type": "composer"，否则 Composer 会把它当普通 URL 处理，后续请求直接 fallback 到默认源。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ 正确：第二个参数composer是 type 值 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌ 错误：缺 type，配置写入但无效 - 末尾斜杠不能省：
https://mirrors.ustc.edu.cn/composer/有效，https://mirrors.ustc.edu.cn/composer在部分 Composer 版本下返回 404
项目级镜像覆盖全局配置的隐藏优先级规则
即使你全局配了阿里云镜像，只要项目根目录下的 composer.json 里有 "repositories" 字段，它就会无条件覆盖全局设置——这是 Composer 的硬编码优先级：项目 > 用户（~/.composer/config.json）> 全局（repo.packagist）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 常见陷阱：团队模板里自带
"repositories": [{"type": "composer", "url": "https://packagist.org"}]，一拉代码就失效 - 验证是否被覆盖：运行
composer config repo.packagist（不加-g），如果输出为空或报错，说明项目级配置接管了 - 临时绕过所有仓库配置：用
--repository-url=https://mirrors.tencent.com/composer/参数强制指定，比如composer update --repository-url=https://mirrors.tencent.com/composer/
composer diagnose 比 --version 更早暴露真实问题
composer --version 只检查命令能否执行；composer diagnose 才真正模拟一次完整请求流程，能揪出镜像配置后仍存在的底层障碍。
- 它会检测 CA 证书是否可信（尤其在企业内网或 Docker 容器中常缺失）
- 检查
~/.composer目录是否可写（权限错误会导致缓存写入失败，后续所有操作变慢） - 确认 SSL 是否启用、DNS 是否能解析镜像域名（例如
ping mirrors.cloud.tencent.com） - 如果输出里还有
Repo packagist.org is default，说明镜像根本没生效，别急着重装，先查配置键名和项目级覆盖
换镜像后必须清缓存，否则旧源还在内存里苟着
配置更新不会自动刷新已下载的元数据缓存。你改完 repo.packagist，但 packages.json 还是从旧源缓存里读的，结果就是“设了等于没设”。
- 立刻执行：
composer clear-cache，它会清掉~/.composer/cache/下所有内容 - 验证是否清干净：删完再跑
composer show laravel/framework 11.* --no-ansi | head -n 5，观察 URL 是否含镜像域名 - 阿里云镜像偶尔同步延迟（约 1–2 小时），若某个新版本死活拉不到，可临时切回官方源验证：
composer config -g --unset repos.packagist
镜像不是“提速选项”，是让 Composer 在国内能跑起来的基础设施。最容易被忽略的是项目级 repositories 覆盖和缓存未清——这两点占实际故障的七成以上。
