直接修改 composer.json 不生效是因为 Composer 优先使用全局配置，项目级配置仅作 fallback；应执行 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 全局设置镜像源。
为什么直接改 composer.json 不生效
很多人编辑项目根目录下的 composer.json，在 "repositories" 里加阿里云镜像源，结果 composer install 还是走官方源——因为 Composer 默认优先使用全局配置，项目级配置只在没有全局镜像时才 fallback。真正起效的方式是改配置文件或命令行强制指定。
全局切换到阿里云镜像（推荐）
执行这条命令一次，之后所有项目都默认走阿里云源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：
composer config -g repo.packagist
输出应为 https://mirrors.aliyun.com/composer/。注意：-g 表示 global，配置写入 ~/.composer/config.json（Windows 是 %USERPROFILE%\AppData\Roaming\Composer\config.json）。
立即学习“PHP免费学习笔记（深入）”；
- 如果报错
Could not find package ...，先运行composer self-update确保版本 ≥ 2.0 - 旧版 Composer（
- 公司内网可能拦截
mirrors.aliyun.com，可临时换用https://php.cnpkg.org测试连通性
临时切换（单次命令生效）
不想改全局配置？加 --repository 参数即可：
composer install --repository=https://mirrors.aliyun.com/composer/
或者更彻底地绕过所有配置，强制使用镜像：
composer install -n --no-plugins --repository=https://mirrors.aliyun.com/composer/
适用场景：
- CI/CD 流水线中避免污染构建机全局配置
- 调试依赖安装失败时快速验证是否源的问题
- 团队协作中不同成员本地配置不一致，统一用命令行参数兜底
验证镜像是否真在用
光看命令没报错还不够。实际请求发到了哪？最可靠的方法是加 -v（verbose）观察日志：
composer require monolog/monolog -v
留意输出中类似这样的行：
Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json
如果看到的是 packagist.org 或 repo.packagist.org，说明镜像没生效。常见原因：
- 项目
composer.json中定义了"repositories"且包含{"type": "composer", "url": "https://packagist.org"}—— 它会覆盖全局配置 - 存在
COMPOSER_REPO_PACKAGIST环境变量，优先级高于全局 config - 某些 Docker 镜像（如
php:alpine）自带预设的 Composer 配置，需在构建阶段清理
阿里云镜像本身不缓存私有包，如果你的项目依赖了 GitLab 私仓或 GitHub private repo，它们不受影响，只加速 packagist.org 上的公开包。
