composer换源失败主因是镜像配置错误：键名必须为repo.packagist、type必须显式设为composer、url须https且末尾带/；项目级repositories字段会完全屏蔽全局配置，权限和缓存问题亦常见。
Composer install 报错，八成不是网络差或 PHP 坏，而是镜像根本没配对——漏一个斜杠、少个 composer 类型参数、键名写成 repos.packagist，它就安静退回 https://packagist.org，不报错也不提示。
为什么 composer config -g repo.packagist 看起来成功却没生效
这条命令静默失败有三个硬条件必须同时满足：
-
repo.packagist是唯一合法键名（不能是repos.packagist、repositories.packagist或packagist.org） - 中间必须显式传入
composer作为type值：漏掉它，Composer 2.x 直接忽略该配置 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（拼路径时变成/composerpackages.json，404）
验证是否真写进去了：运行 composer config -g repo.packagist。输出必须是完整 JSON 对象，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍返回 https://packagist.org，说明没写对。
项目级配置比全局更可靠，尤其在宝塔/CI/Docker 中
全局配置写在 ~/.composer/config.json，但只要项目根目录 composer.json 里存在 "repositories" 字段（哪怕只是 "repositories": []），全局设置就完全被跳过——不是优先级低，是彻底失效。
更关键的是权限问题：
- 宝塔默认用
www用户执行命令，你在终端用root配的全局配置，www根本读不到 - CI runner（如 GitHub Actions）或 Docker 容器里可能根本没有
~/.composer目录
推荐做法：进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）。它会自动合并到 composer.json 的 repositories 字段中，key 固定为 "packagist"。如果原 composer.json 是 "repositories": []，需先手动改为 "repositories": {} 再执行，否则报错。
composer install 卡在 “Loading composer repositories” 怎么办
这行日志背后是 Composer 在拉取全量元数据（packages.json），不是下载包本身。默认走 https://packagist.org，DNS 解析慢、TLS 握手不稳定、CDN 节点远，国内直连成功率极低。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 才是真实请求地址；只看composer config输出没用 - 检查项目根目录
composer.json是否含"repositories"字段：哪怕只是空数组[]，也会完全屏蔽全局镜像 - 执行
composer config --unset repositories（注意没-g）临时清掉项目级配置 - 删掉
vendor/和composer.lock——composer.lock里硬编码了旧 provider 地址，不删它，Composer 就一直重试失败路径
镜像源必须同时提供元数据接口和 ZIP 包分发节点，二者 URL 不匹配会报 Package not found 或 Signature mismatch。阿里云、腾讯云、清华镜像同步频率高（5 分钟内），且完整支持 HTTPS 元数据 + dist 包分发。
换源后仍报 404、SSL 错误或 JSON decode error
这不是网络不通，而是缓存残留、元数据损坏或镜像同步延迟导致 Composer 拿着旧路径去新源上找不存在的东西。
必须做三件事：
- 先执行
composer clear-cache；Windows 用户还得手动删%LOCALAPPDATA%\Composer\cache - 删掉
vendor/和composer.lock - 手动验证镜像可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200；若返回 HTML 页面（如人机验证），说明该镜像不适合自动化场景
某些错误（如 file_put_contents(): Only variables should be passed by reference）其实是镜像返回了乱码或 BOM 头，不是 PHP 语法问题，换阿里云/腾讯云源即可。
最常被忽略的点：你配的镜像 URL 末尾缺斜杠，或者 composer.json 里早就有 repositories 字段，这两件事单独发生都足以让整个换源操作完全失效，而 Composer 连 warning 都不给你。
