执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 即可全局启用阿里云镜像，该命令直接写入用户级配置文件，优先级最高，无需重启终端或清缓存。
直接执行这行命令就能全局生效
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，所有后续的 composer install 和 composer update 就会自动走阿里云镜像，不用重启终端、不用清缓存、也不用改项目文件。
它直接写入你当前用户的全局配置文件（通常是 ~/.composer/config.json 或 ~/.config/composer/config.json），这是 Composer 启动时优先读取的最高级别用户级配置。
- 别拼错字段名：
repo.packagist不是repos.packagist，也不是repositories.packagist—— 拼错就写进错误位置，配置不生效 - Windows 用户如果用 Git Bash，
COMPOSER_HOME环境变量可能没生效，最可靠的方式是打开%APPDATA%\Composer\config.json看内容是否已更新 - 验证是否成功？运行
composer config -g repo.packagist，输出应为：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
为什么不是腾讯云或 Laravel China 镜像
阿里云镜像目前是唯一稳定全量同步、HTTPS 可靠、索引完整且持续维护的国内源。腾讯云镜像偶发延迟（比如新发布的 laravel/framework v11.0.0 可能晚几小时上线），而 Laravel China 镜像已于 2025 年底停止维护，访问直接返回 404；老的 phpcomposer.com 也已停更，会触发 cURL error 60: SSL certificate problem。
- 别用
http://开头的旧地址 —— Composer 2.x 默认禁用非 HTTPS 源，会报Invalid repository type, expected 'composer' - 阿里云不支持上传私有包，但如果你只是下载公共包，它就是目前最优解
- CI/CD 流水线里如需 fallback 更友好（官方源挂了自动切），可用腾讯云：
https://mirrors.cloud.tencent.com/composer/，但末尾斜杠不能少
项目级配置 vs 全局配置：什么时候该用哪个
全局配置省事，但团队协作时容易被个人设置干扰；项目级配置可 Git 跟踪、环境一致，适合交付和 CI。
- 只给当前项目换源（不影响别人）：进项目根目录后执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它会在composer.json中添加"repositories"字段 -
composer.json中的repositories优先级高于全局配置 —— 一旦写了，就以它为准；删掉后若忘记清缓存，composer install可能仍走旧源，得补一句composer clear-cache - 如果项目还用了私有仓库（比如 GitLab），又没显式保留
packagist条目，Composer 默认会禁用官方源，导致Could not find package xxx
镜像到底加速了什么，又没加速什么
阿里云镜像是「全量索引镜像」，只同步 packages.json 和元数据，不托管 ZIP 包本身。它解决的是「找包慢」，不是「下载慢」。
- ✅ 加速的操作：
composer install前的依赖解析、composer search、composer show这类读取索引的行为 - ❌ 不加速的操作：实际下载 ZIP 包时，仍走 GitHub / GitLab / Packagist dist URL —— 这部分速度取决于你本地网络对这些站点的访问能力
- 如果你内网完全不能出外网，光配阿里云镜像没用，得用
satis搭本地离线仓库，把包和索引一起搬进来
最容易被忽略的一点：改完配置不生效，90% 是缓存或权限问题，不是镜像地址写错了；尤其 Windows 下不同终端（CMD/PowerShell/Git Bash）可能读取不同路径的 config.json，直接打开对应文件看内容最靠谱。
