composer config -g repo.packagist 不生效是因为键名必须为单数小写 repo.packagist、type 值必须显式写 composer、url 必须以 https:// 开头且末尾带 /，三者缺一即静默回退官方源；验证需检查 config 输出是否为完整 json、diagnose 中 repo 域名匹配及 -vvv 日志请求地址。
composer config -g repo.packagist 总不生效？检查拼写、type 和末尾斜杠
全局镜像配置失效，90% 是因为 repo.packagist 键名写错（比如多写一个 s 变成 repos.packagist），Composer 2.x 会静默忽略，不报错也不提示。执行后必须验证输出是否为完整 JSON：composer config -g repo.packagist 应返回类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的结构，而不是空、null 或 https://packagist.org。
常见遗漏点：
-
type字段不能省略，必须显式写composer - URL 必须以
https://开头，且末尾带/（如https://mirrors.aliyun.com/composer/，少斜杠会导致 404） - Composer 1.x 不支持该语法，需改用
composer config -g repos.packagist '{"type":"composer","url":"..."}'（注意是repos复数形式） - WSL 或 Docker 容器中，
~/.composer/目录可能不可写，需手动chown或chmod
为什么 composer install 还在请求 packagist.org？优先级和 fallback 规则
Composer 的源选择不是“覆盖”，而是严格按优先级：项目级 repositories > 临时 --repository > 全局 repo.packagist。只要项目根目录的 composer.json 含 "repositories" 字段（哪怕只是空数组 {} 或空列表 []），全局配置就完全失效。
排查方法：
- 运行
cat composer.json | grep repositories，确认是否存在该字段 - 若存在，检查是否含
"packagist": false—— 这会禁用所有 packagist 源，但又没显式定义新的"packagist"key，结果就是回退到官方源 - 私有包、
path类型仓库、标记为abandoned的包，也会绕过镜像直接回源拉取元数据 - 镜像同步有 5–30 分钟延迟，新发布版本（如
laravel/framework v11.0.0）可能尚未同步，可用composer show vendor/package -vvv观察真实请求域名
换源后仍卡在 “Loading composer repositories”？必须清缓存
Composer 不会自动丢弃旧缓存。哪怕镜像已换，它仍可能从 packagist.org 的旧元数据里解析依赖，导致卡在该步骤超 30 秒。清缓存命令只有一条：composer clear-cache。别跳过这步，也别指望 composer update -v 自动刷新。
如果已卡住：
- 先
Ctrl+C安全终止 - 再执行
composer clear-cache - 最后重试
composer install或composer update - 不推荐直接删
vendor/和composer.lock—— 那是重装逻辑，不是解决卡顿的常规手段
宝塔面板或 CI 环境下，root 配了但 PHP 进程没生效？用户权限与 CLI 路径要对齐
宝塔等面板环境里，root 用户执行了全局配置，但 PHP 进程实际以 www 用户运行，导致镜像配置不生效。必须额外给 www 用户也执行一次 composer config -g repo.packagist ...。
关键操作点：
- 确认网站根目录路径（如
/www/wwwroot/example.com）和绑定的 PHP 版本（如 8.1） - 使用对应 PHP CLI 执行命令：
/www/server/php/81/bin/php /usr/local/bin/composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 检查 CLI 对应的
php.ini是否启用openssl和curl扩展 - CI 环境建议用临时单次换源：
composer update --repository=https://mirrors.aliyun.com/composer/，避免污染全局配置
镜像地址本身容易被忽略的是路径细节：阿里云是 https://mirrors.aliyun.com/composer/，华为云是 https://mirrors.huaweicloud.com/repository/php/composer/，腾讯云是 https://mirrors.cloud.tencent.com/composer/ —— 少一个层级或错一个斜杠，就会静默失败。
