composer config -g repo.packagist 无反应是因为三个硬性条件缺一即静默失效：键名必须为单数 repo.packagist、type 值必须显式写 composer、url 必须 https 且末尾带 /；验证需输出完整 json 对象。
composer config -g repo.packagist 命令为什么没反应
这条命令执行后没报错、也没提示，但composer install依然走官方源——不是网络问题，而是三个硬性条件缺一即静默失效：
-
repo.packagist必须是单数形式，写成repos.packagist或packagist.org完全无效 - 中间的
composer是type值，不是可选参数，漏掉就 fallback 到https://packagist.org - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求/composerpackages.json而 404）
验证是否写入成功，只跑这一句：composer config -g repo.packagist。输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报Key not found，说明根本没写进去。
Windows 下 composer --version 报错，先别配镜像
composer不是独立程序，它依赖 PHP CLI 环境。如果php -v都报错，配镜像毫无意义。
- 确认 PHP 已安装并加入系统 PATH：运行
echo %PATH%，检查是否含 PHP 安装路径（如C:\php）和 Composer 的C:\ProgramData\ComposerSetup\bin - 安装 Composer 时务必勾选 Add to PATH（新版安装器默认不勾）；漏了就得手动加，加完必须新开 CMD 或 PowerShell
- 验证 PHP CLI 是否可用：
php -v有输出、php -m | findstr openssl能查到关键扩展
宝塔/CI/计划任务里镜像不生效，用户权限不对
全局配置写在%USERPROFILE%\AppData\Roaming\Composer\config.json，只对当前 Windows 用户有效。宝塔后台、Linux 计划任务、GitHub Actions 默认用www或runner用户运行，压根读不到你的配置。
- 宝塔环境下，进「PHP 管理」→「禁用函数」页签，删掉
putenv、proc_open、pcntl_signal（否则 Composer 直接崩溃） - 给 www 用户单独配镜像：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 流水线中，不要依赖全局配置，改用项目级方式：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（进项目根目录后执行，会写入composer.json）
换源后 still stuck at “Loading composer repositories”
这不是镜像没生效，而是 Composer 在读缓存或旧锁文件。镜像只加速下载，不跳过解析阶段。
- 先清缓存：
composer clear-cache - 删掉项目下的
vendor/和composer.lock - 再跑
composer install -vvv，观察日志里是否出现mirrors.aliyun.com——这才是真正生效的证据 - 若仍卡住，重点看是否因
minimum-stability: dev或宽泛版本约束（如"^2.0"）导致依赖解析爆炸，和镜像无关
镜像 URL 本身有同步延迟（阿里云通常 5–10 分钟），刚发布的包可能还没同步，别急着换源或重试。
