换镜像源可显著提升PHP项目依赖安装速度，临时切换用composer config repo.packagist composer https://mirrors.aliyun.com/composer/写入项目配置，永久切换用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/修改全局配置，需注意项目级配置优先级高于全局，且composer.lock中记录的原始源地址会影响首次install行为。
PHP 项目依赖装不上，大概率不是你操作错了，而是默认的 Packagist 源在国外，DNS 解析慢、连接超时、TLS 握手失败——换中文镜像，composer install 从卡住到秒过，这事真不难。
怎么临时换源？只对当前项目生效
适合调试或 CI 环境临时验证，不影响全局配置。执行前确保已在项目根目录：
- 运行
composer config repo.packagist composer https://packagist.phpcomposer.com（已停用，别用） - 改用清华源：
composer config repo.packagist composer https://packagist.mirrors.ustc.edu.cn - 或阿里云源：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 执行后会写入当前项目的
composer.json的repositories字段，下次composer install自动走镜像
怎么永久换源？避免每个项目都配
改的是用户级配置，所有新项目默认继承，老项目需重新 composer update 才会拉取新源的包信息：
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 查看是否生效：
composer config -g repo.packagist，输出应为对应 URL - 注意：如果之前手动在某个项目里设过
repo.packagist，它会覆盖全局设置，优先级更高 - 想恢复默认源？删掉配置：
composer config -g --unset repos.packagist
为什么装依赖还是慢？检查这几个点
换了镜像还卡在 Resolving dependencies 或 Loading from cache，问题往往不在源本身：
立即学习“PHP免费学习笔记（深入）”；
-
composer.lock文件里记录的是原始源的包哈希，换源后首次composer install仍要解析依赖树，耗时跟本地 CPU 和composer.json复杂度有关 - PHP 版本不匹配：比如
composer.json声明"php": "^8.1"，但本地是 7.4，Composer 会反复尝试兼容版本，卡住不动 - 启用了
xdebug：它会让 Composer 解析速度下降 5–10 倍，装依赖前先关掉：php -d xdebug.mode=off composer install - 某些包含大量
require-dev或嵌套repositories，镜像可能未同步其私有源，得单独处理
镜像只是加速下载，解决不了依赖冲突或 PHP 版本错位。真正省时间的地方，是把 composer install 从等两分钟变成等两秒——但前提是你的 composer.json 本身没写错，且本地环境干净。
