composer全局镜像配置失效主因是字段名必须为单数repo.packagist，写成repos.packagist等均静默回退官方源；验证需输出完整json，且须清缓存、删vendor与lock、排除项目级repositories覆盖及权限问题。
全局镜像配置写错字段名就完全失效
Composer 2.x 对 repo.packagist 字段名极其敏感，写成 repos.packagist、repositories.packagist 或 repo.packagist.org 都不会报错，而是直接静默 fallback 到 https://packagist.org。你运行 composer config -g repo.packagist 看不到输出，或输出为空/不是 JSON 对象，说明配置根本没存进去——不是“没生效”，是压根没写成功。
- 必须用单数
repo.packagist，且后面紧跟composer类型标识：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须以
/结尾，缺斜杠会导致拼出/composerpackages.json这种非法路径 - 漏掉
-g参数，只改当前项目composer.json，换目录就失效
项目级 repositories 字段会彻底屏蔽全局镜像
哪怕 composer.json 里只写了空数组 "repositories": []，Composer 就会忽略所有全局镜像配置，强制走官方源。这种覆盖是无提示的，composer install -vvv 日志第一行 Downloading 的 URL 才是真实请求地址，别只信 composer config 输出。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时验证：运行
composer config --unset repositories（注意没有-g）清掉项目级配置 - CI/CD 或宝塔环境常见陷阱：用
root配了全局镜像，但实际执行的是www用户，得用sudo -u www composer config -g单独配 - 某些错误如
file_put_contents(): Only variables should be passed by reference其实是镜像返回了 BOM 头或乱码，换阿里云/腾讯云源即可解决
缓存残留让 Composer 拿着旧路径去新源上撞墙
切镜像后仍报 404、SSL error 或 JSON decode error，不是网络不通，而是缓存里存着旧 provider 地址，composer.lock 也硬编码了旧路径。Composer 会拿着这些旧信息去新镜像上找不存在的东西。
- 必须先执行
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache - 删掉
vendor/和composer.lock——不删composer.lock，Composer 就永远重试失败路径 - 手动验证镜像可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200；若返回 HTML 页面（如人机验证），说明该镜像不适合自动化场景
权限错配让 Composer 在正确路径上反复失败
报 Permission denied 写 vendor/ 或 composer.lock，90% 不是权限不足，而是目录归属被 sudo 污染过，属主是 root，而你正以普通用户运行命令。终端报错里带路径的那一行就是线索：file_put_contents(/home/alex/myapp/vendor/autoload.php): Permission denied → 问题在 vendor/。
- 立刻查归属：
ls -ld vendor/ composer.lock $(composer config --global cache-dir)，只要任意一行显示root，就是所有权错配 - 禁用
chmod -R 777——它会让vendor/bin/phpunit被 CI 工具拒收，后续composer update可能半途失败 - 正确做法：
sudo chown -R $USER:$USER vendor/ composer.lock和sudo chown -R $USER:$USER $(composer config --global cache-dir)
-g 参数、无项目级覆盖、无缓存干扰、无归属污染——任何一个环节出偏，composer install 就会在你看不见的地方悄悄退回到官方源，或者卡在不可见的权限/路径错误上。
