直接执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可全局生效，但必须严格满足三项：键名repo.packagist（非repos）、type值composer不可省略、url须为https且末尾带斜杠；验证需输出完整json，否则配置失败。
直接执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 就能生效，但漏掉任意一个细节都会静默失败——不是没换，是根本没写对。
确认 PHP 和 Composer 已就位
别跳过这步。Composer 是 PHP 脚本，composer --version 报错时，90% 是因为 php 命令本身不可用。
先运行 php -v，确保输出 PHP 版本号；再检查 composer 是否在 PATH 里：
Windows 用户常见问题是安装时没勾选 “Add to PATH”，或装完没新开终端；
Linux/macOS 用户要确认 /usr/local/bin 或 ~/.composer/vendor/bin 是否已加入 $PATH。
执行全局镜像命令的三个硬性要求
这条命令必须严格满足三项，缺一不可，否则不报错、不提示、也不生效：
-
repo.packagist是唯一合法键名（注意是repo单数，不是repos） -
composer是 type 值，不能省略（写成composer config -g repo.packagist https://...就会 fallback 到官方源） - URL 必须是 HTTPS，且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
正确命令（可直接复制）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否真正生效
别凭感觉，用命令确认：
- 运行
composer config -g repo.packagist - 输出必须是完整 JSON：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果返回空、
null、或仍是"https://packagist.org"，说明配置失败 - 常见干扰项：公司内网拦截 HTTPS、PowerShell 中路径符号混淆、权限不足导致写入失败
若验证失败，先清缓存：composer clear-cache，再重试配置命令。
换源后 install 还卡住？可能根本不是镜像问题
composer install 卡在 Loading composer repositories with package information —— 这才是镜像没生效的典型表现；
但如果卡在 Resolving dependencies 或 Installing dependencies，那和镜像无关：
- 镜像只加速包下载，不加速依赖解析
-
composer.lock里记录的是原始 dist URL，换源后首次运行需删掉vendor/和composer.lock再install - 私有包、GitHub 直链包、platform 配置项不走 Packagist，镜像对其无效
- 同步延迟：新发布的包可能 5–30 分钟后才出现在阿里云镜像站，查不到时先去
https://mirrors.aliyun.com/composer/packagist/搜一下
最常被忽略的一点：全局配置只影响新项目，老项目若已有 repositories 字段，会覆盖全局设置——得进项目目录单独处理。
