全局镜像配置需修改config.json中repositories.packagist字段，Linux/macOS路径为~/.composer/config.json，Windows为%APPDATA%\Composer\config.json；必须设为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，URL末尾斜杠不可省。
config.json 文件在哪，改哪个字段
Composer 的全局镜像源配置写在 config.json 里，位置取决于系统：Linux/macOS 在 ~/.composer/config.json，Windows 在 %APPDATA%\Composer\config.json。如果文件不存在，运行 composer config -g repo.packagist composer https://packagist.phpcomposer.com 会自动生成；但更推荐手动创建，避免意外覆盖已有配置。
关键字段是 repositories 下的 packagist 条目，它控制 Packagist 官方源是否启用及是否被替换。不是改 repositories 数组末尾加新源，而是必须显式重定义 packagist 这个保留键名。
镜像源 URL 填什么，为什么不能只填域名
国内常用镜像如阿里云、腾讯云、华为云都要求使用完整 HTTPS 地址，并且必须带 / 结尾（否则 Composer 会拼接错误路径导致 404）。例如：
{
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
}
url 字段值不是 https://mirrors.aliyun.com，也不是 https://mirrors.aliyun.com/composer（缺结尾斜杠），否则 composer install 时会请求类似 https://mirrors.aliyun.com/packages.json 这样的错误地址。
- 清华源已停止服务，
https://packagist.phpcomposer.com已失效，继续使用会导致Could not fetch https://packagist.phpcomposer.com/packages.json - 华为云镜像需登录华为云账号并开通 Composer 镜像服务，URL 形如
https://repo.huaweicloud.com/repository/php/，注意末尾斜杠 - 所有镜像都仅代理 Packagist 元数据和 ZIP 包，不代理 GitHub/GitLab 等 VCS 源——换源后
composer create-project如果拉的是 GitHub 仓库，仍走原网络
全局配置 vs 项目级配置，哪个优先级高
项目根目录下的 composer.json 中定义的 repositories 会完全覆盖全局 config.json 的设置，包括 packagist 条目。也就是说，只要项目 composer.json 里有 "repositories": [...]，全局镜像就失效。
常见踩坑点：
- 用
composer create-project laravel/laravel新建项目后，Laravel 自带的composer.json包含"repositories": {"packagist.org": false}，这会禁用所有 Packagist 源（包括镜像），导致后续composer require报错No valid package could be found - 解决方法：删掉项目
composer.json里的repositories字段，或改为显式启用镜像："packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 想临时绕过镜像？运行
composer install --no-plugins --no-scripts不行，必须加--repository=https://packagist.org才能指定源
验证镜像是否生效，怎么看实际请求地址
别只信 composer diagnose 的 “OK”，它不检测镜像是否真实可用。最直接的方式是加 -v 参数看详细日志：
composer require monolog/monolog -v
观察输出中类似这样的行：Downloading https://mirrors.aliyun.com/composer/p2/monolog/monolog.json —— 如果域名是你配的镜像站，说明生效；如果还是 packagist.org 或报 404/timeout，就要回头检查 config.json 路径、JSON 格式、URL 斜杠、以及项目级配置是否覆盖了它。
另外，Composer 1.x 和 2.x 对 config.json 的解析逻辑一致，但 2.2+ 版本开始默认启用插件隔离，某些自定义镜像插件（如 hirak/prestissimo）可能干扰源选择，遇到异常可先试 composer --no-plugins require ... 排查。
