必须配置国内镜像源，最稳妥方式是全局执行composer config -g repo.packagist composer ，如阿里云https://mirrors.aliyun.com/composer/，清华源已更新为https://mirrors.tuna.tsinghua.edu.cn/composer/，旧地址packagist.phpcomposer.com已下线。
Composer 默认源在国外，国内直连经常超时、卡死或安装失败——换国内镜像不是可选项，是必须做的第一步。
怎么快速切换到清华、阿里或华为镜像
最稳妥的方式是全局配置，避免每次项目都手动设。执行以下任一命令即可：
- 清华镜像：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：该地址已停用，现应为https://mirrors.tuna.tsinghua.edu.cn/composer/） - 阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 华为云镜像：
composer config -g repo.packagist composer https://repo.huaweicloud.com/repository/php/
执行后，composer install 或 composer update 会自动走镜像源。验证是否生效：运行 composer config -g repo.packagist，输出应为对应镜像 URL。
为什么 packagist.phpcomposer.com 现在不能用了
这个曾经流行的镜像早在 2022 年底已下线，但很多老教程、脚本还在引用它。继续使用会导致：
-
Connection refused或SSL certificate problem错误 -
composer create-project卡在 “Loading composer repositories” 阶段 - 部分依赖解析失败，报
Could not parse version constraint
务必检查 ~/.composer/config.json 中的 repo.packagist 字段，手动删掉旧地址，换成当前有效的镜像 URL。
项目级镜像配置比全局更安全
团队协作或部署敏感项目时，全局镜像可能干扰测试环境一致性。推荐在项目根目录运行：
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 该命令会写入项目内
composer.json的repositories字段，提交后所有协作者自动复用 - 若同时存在全局和项目级配置，项目级优先级更高
注意：repositories 是数组结构，别手写错格式；建议用命令行操作，避免 JSON 语法错误导致 composer validate 失败。
镜像同步延迟与 dev 版本陷阱
国内镜像通常每 5–30 分钟同步一次 packagist.org，这意味着：
- 新发布的包（尤其是
dev-main或dev-develop）可能几小时内查不到 -
composer require vendor/package:dev-master容易因镜像未同步而报Could not find package - 临时解法：加
--prefer-source强制从 Git 拉取，或临时切回官方源composer config -g repo.packagist composer https://packagist.org
真正要命的是，有些 CI 流程硬编码了镜像地址却没做 fallback，一旦镜像短暂不可用，整个构建就挂——别只图快，得留个退路。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
