镜像配置需同时满足四要素：键名repo.packagist、type值composer、url以/结尾、加-g参数，缺一即静默回退至packagist.org；配置失败常因键名错误、type缺失、url末尾无/或未用-g导致。
镜像配置写了却没生效，不是 Composer 坏了，而是 repo.packagist 这个键名、composer 这个 type 值、URL 末尾的 /、以及 -g 参数，四者缺一不可——漏掉任意一个，Composer 都静默回退到 packagist.org，且不报错。
composer config -g repo.packagist 为什么总返回空？
这是最常踩的坑：命令看似执行成功，但 composer config -g repo.packagist 输出为空或 null，说明配置根本没写进去。
- 键名必须是
repo.packagist（单数，不能是repos.packagist或packagist.org） -
composer是强制 type 值，不是可选注释；漏掉它，整条配置被忽略 - URL 必须以
https://开头且末尾带/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/packages.json错误路径，返回 404 后静默 fallback - 必须加
-g（即--global），否则只写入当前项目composer.json的repositories字段，换个项目就失效
明明配了镜像，install 却还是卡在 “Loading composer repositories”
这不是镜像慢，而是请求压根没发到镜像站——大概率是项目级配置覆盖了全局设置，或者 composer.json 里写了禁用语句。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 repositories（项目级），确认哪一层实际生效 - 检查
composer.json是否存在"packagist.org": false或"packagist": false这类彻底关源的字段 - 如果
repositories是数组格式（[]），composer config repo.packagist会失败；需先手动改成对象格式（{}）再运行 - 临时验证镜像可达性：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回HTTP/2 200才算服务正常
换镜像后报 “hash verification failed” 怎么办？
这个错误不是网络问题，是 Composer 主动拒绝加载：它发现下载的 zip 包和 composer.lock 里记录的 dist.sha256 对不上。只删 vendor/ 或只清缓存，95% 白忙。
- 必须同步清除三样东西：
vendor/、composer.lock、缓存（composer clear-cache） - Windows 用户注意：要用
rd /s /q vendor & del composer.lock，Linux/macOS 用rm -rf vendor composer.lock - 删之前建议备份：
cp composer.lock composer.lock.bak - 更稳妥的做法是：先切回官方源（
composer config -g --unset repos.packagist），清缓存，删干净，再composer install生成全新锁文件；等几分钟后再切回阿里云镜像
CI/CD 或 Docker 里镜像配置不生效？
全局配置在 CI/CD 或容器中极易失效：GitHub Actions 默认没有 ~/.composer，Docker 构建用户可能是 www-data，宝塔后台用的是 www 用户——这些场景下你配的 repo.packagist 根本读不到。
- 项目级配置更可靠：运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会安全写入当前项目的composer.json的repositories字段，且只新增"packagist"子项，不覆盖已有私有源 -
composer.json可提交 Git，团队成员拉代码后行为一致 - CI 脚本里不用额外处理用户权限或
COMPOSER_HOME路径 - 若项目
composer.json中repositories已是数组（[]），该命令会失败；需先手动改为对象（{}）再执行
最容易被忽略的点是：改完镜像不清理缓存，配置等于白配；而缓存目录（~/.composer/cache）在不同系统、不同用户、不同容器里位置可能完全不同——别凭经验猜路径，先用 composer config --global --list 看第一行输出的真实配置路径。
