composer install卡在packagist.org是因为默认直连境外源，受dns解析慢、tls握手抖动和路由丢包影响；应配置阿里云等国内镜像（如https://mirrors.aliyun.com/composer/），并确保repo.packagist键名正确、type为composer、url以/结尾，同时执行composer clear-cache验证生效。
为什么 composer install 总卡在 packagist.org？
因为默认源是国外的 packagist.org，国内直连不稳定、超时频繁，尤其在 CI/CD 或新机器首次安装时容易失败。这不是你网络差，是 DNS 解析慢 + TLS 握手抖动 + 中间路由丢包叠加导致的。
临时解决可以用 composer config -g repo.packagist composer https://packagist.phpcomposer.com，但这是旧镜像，已停用；现在主流是阿里、腾讯、华为三家，推荐优先试 https://mirrors.aliyun.com/composer/（稳定、同步及时、支持 HTTPS）。
- 别用
composer config -g repos.packagist直接覆盖全局——它会把整个 packagist 源替换成镜像，但某些私有包或 vcs 类型依赖可能因此无法解析 - 真正安全的做法是只改
repo.packagist的url字段，保持 type 为composer - 如果项目里已有
composer.json，加了repositories数组，记得把自定义源放在最前面，否则会被 packagist 默认源兜底，起不到加速作用
如何为单个项目设置镜像而不影响全局？
直接改项目根目录下的 composer.json，在顶层加 repositories 字段即可，Composer 会自动优先使用它。
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
],
"require": { ... }
}
注意：这个配置不会覆盖 packagist.org 的元数据结构，只是把请求代理过去；所有包名、版本约束、autoload 规则完全不变。
- 不要写成
"packagist.org": false—— 这个写法只在 Composer 2.2+ 有效，且必须配合"allow-plugins"控制，容易误关插件 - 如果用了私有仓库（比如 GitLab Package Registry），把它和镜像一起列在
repositories里，顺序很重要：越靠前优先级越高 - 执行
composer update --with-all-dependencies后，composer.lock里的packages条目会记录实际下载源地址，可用于排查是否真走镜像
composer global 命令装的工具为什么没走镜像？
因为 composer global require 默认读的是全局配置（~/.composer/config.json），不是项目配置。即使你在项目里设了镜像，global 命令也看不见。
验证方式：运行 composer config -g repo.packagist，如果输出为空或还是 https://packagist.org，说明全局没生效。
- 正确设置：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 别漏掉中间的
composer—— 这是 type，不是随便写的字符串，写错会导致配置被忽略 - 如果之前用过其他镜像（比如腾讯云），先删掉旧配置：
composer config -g --unset repos.packagist，再重新设，避免冲突 - 某些 CI 环境（如 GitHub Actions）中，
composer global安装的 bin 文件路径不在$PATH，需手动加~/.composer/vendor/bin
镜像失效或同步滞后怎么办？
没有永远可靠的镜像。阿里云偶尔延迟几小时，腾讯云对某些带特殊符号的包名（如含 + 或 %）解析异常，华为云不支持部分私有协议头。
最有效的应对不是换镜像，而是留退路：用 composer config 动态切源，或加 --repository 参数临时指定。
- 临时切源命令：
composer install --repository=https://packagist.org，绕过所有配置直接走官方源 - 检查镜像状态：访问
https://mirrors.aliyun.com/composer/packages.json，能返回 JSON 就代表服务正常；返回 404 或超时就该切换 - 如果团队多人协作，把镜像 URL 写进项目 README，比写进
composer.json更灵活——毕竟有人可能想本地调试时用官方源查最新 dev 分支
镜像不是银弹，关键在可切换、可验证、可回退。别把所有鸡蛋放进一个镜像里，哪怕它标着“最快”。
