composer config -g repo.packagist 命令不生效是因为必须同时满足三个硬性条件：键名严格为 repo.packagist（单数）、type 值显式写 composer、url 为 https 且末尾带 /，任一缺失即静默回退官方源；验证需执行 composer config -g repo.packagist 输出完整 json 对象。
composer config -g repo.packagist 命令不生效？先看输出是不是完整 JSON
执行完 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后没反应，不代表成功。必须立刻验证：composer config -g repo.packagist 的输出必须是形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。
常见失效原因：
-
repo.packagist写成repos.packagist（多一个 s），Composer 完全忽略，也不报错 - 漏掉中间的
composer类型声明，命令变成composer config -g repo.packagist https://...，直接静默 fallback 到官方源 - URL 少了末尾斜杠：
https://mirrors.aliyun.com/composer❌ → 请求会拼成/composerpackages.json导致 404 - Linux/macOS 下
~/.composer目录权限不属于当前用户，需先运行chown -R $USER ~/.composer
全局配置 vs 项目级配置：谁在真正起作用？
全局配置（带 -g）写入 ~/.composer/config.json，只对当前 shell 用户生效；项目级配置写入项目根目录下的 composer.json 的 repositories 字段，优先级更高，且可提交 Git。
实际场景判断：
- 本地开发机用全局配置省事：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队协作或 CI 环境（GitHub Actions、宝塔后台、Docker）必须用项目级：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g，且确保在项目根目录） - 宝塔里 PHP 进程常以
www用户运行，得切用户配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果
composer.json里已有"repositories": []（数组格式），命令会失败；需先手动改成"repositories": {}（空对象）再执行
换源后还是卡在 “Loading composer repositories”？清缓存和锁文件
镜像地址改了，但 Composer 仍可能读缓存或旧 composer.lock 里的元数据 URL，导致请求发往 packagist.org。
必须做这三件事：
- 运行
composer clear-cache清掉本地缓存 - 删掉项目下的
vendor/和composer.lock - 再执行
composer install -vvv，观察日志里是否出现mirrors.aliyun.com - 若仍卡住，加
--no-cache强制跳过缓存：composer install --no-cache
HTTPS 校验失败或镜像站 404？别硬扛，先确认环境
企业内网或某些 CI 环境中，HTTPS 中间件劫持会导致证书校验失败，报错类似 SSL certificate problem: unable to get local issuer certificate。
临时绕过（仅限可信环境）：composer install -n（-n 即 --no-interaction，同时隐含跳过证书校验）。
长期方案不是关 HTTPS，而是：
- 联系运维部署内部 Composer 代理
- 将镜像站证书加入系统信任链
- 避免使用已停用源：
https://packagist.phpcomposer.com已不可用，curl 会报Could not resolve host - 华为云镜像偶尔同步延迟略高，新包发布后建议等 5–10 分钟再试
配置镜像本身很简单，但 Composer 的配置加载逻辑、用户权限、缓存机制、以及不同运行环境（CLI / Web / CI）的用户上下文差异，才是最容易被跳过的复杂点。
