Composer全局镜像未生效是因为repo.packagist键名错误、缺composer类型值或URL末尾无/，三者任一缺失即静默回退官方源；验证需composer config -g repo.packagist输出完整JSON且-vvv日志中GET请求指向镜像域名。
composer config -g repo.packagist 输出为空或报错
这说明全局镜像根本没写进去，不是网络慢，是配置压根没生效。Composer 2.x 对键名、type、URL 格式三者要求极严，漏一不可。
-
repo.packagist必须是单数形式——写成repos.packagist或packagist.org都无效 - 第二个参数必须显式写
composer，不能省略、不能写空字符串、不能当注释用 - URL 必须以
https://开头（内网 ECS 可用http://），且末尾必须带/：例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌ - Windows 用户执行后要重启终端，否则 shell 缓存旧配置，
composer config -g repo.packagist仍显示空
明明配了镜像，install 还卡在 “Loading composer repositories…”
这不是镜像地址慢，而是请求压根没发到镜像站——大概率被项目级 repositories 覆盖了。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repo.packagist和composer config repo.packagist，对比两者输出：如果后者有值，说明项目composer.json里写了"repositories"字段，它优先级更高 - 执行
grep -A3 '"repositories"' composer.json，检查是否含"packagist.org": false、空数组[]或硬编码了https://packagist.org - 只要
repositories存在（哪怕只有一行注释），Composer 就忽略全局镜像；安全做法是删掉整个repositories字段，或确保首位是合法镜像对象：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 已有
composer.lock时，旧文件会固化包地址，务必连同vendor/一起删掉再composer install
curl 测试镜像地址返回 404 或非 JSON 响应
镜像 URL 格式错误或源已失效，会导致 Composer 静默 fallback 到官方源，你只会觉得“换源没用”。
- 手动测元数据接口：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回HTTP/2 200且Content-Type: application/json - 若返回
404，大概率是 URL 少了末尾/；若返回 HTML 页面或乱码，说明镜像源已下线（如https://packagist.phpcomposer.com已停用） - 阿里云内网用户请改用
http://mirrors.cloud.aliyuncs.com/composer/（注意是http，不是https），公网地址在内网反而更慢 - 某些 Docker 镜像或旧系统 OpenSSL 版本过低（
curl_version()中version_numberexport COMPOSER_DISABLE_TLS=1
PHP CLI 环境缺失关键函数，Composer 启动就崩溃
宝塔、Docker 或某些定制 PHP 环境默认禁用 putenv、proc_open、pcntl_signal，Composer 连解析镜像配置的阶段都进不去。
- 宝塔用户：进「PHP 管理」→ 选版本 → 「禁用函数」页签 → 删除这三个函数
- 确认 CLI 使用的是正确 PHP：执行
which php，若指向/usr/bin/php而非宝塔路径，需加软链接，例如ln -sf /www/server/php/80/bin/php /usr/local/bin/php - 验证模块加载：
php -m | grep -E "openssl|tokenizer"，缺任一模块都可能让 Composer 卡死 - 别急着配镜像——先让
composer --version跑通，否则所有换源操作只是给一个瘫痪环境加速报错
