命令没生效是因为三个硬性条件缺一不可：键名必须为单数repo.packagist（非repos）、中间参数composer是必需type值（非可选）、URL必须以/结尾；任一错误均静默回退官方源，且项目级repositories字段会完全屏蔽全局配置。
composer config -g repo.packagist 命令为什么没生效
命令跑完没报错，但 composer install 还是卡在 Downloading 或报 could not find package，八成是这条命令写错了——它不报错，只静默忽略。
必须同时满足三个条件：
-
repo.packagist键名不能多字母、少字母：不是repos.packagist，也不是packagist.org - 中间的
composer是 type 值，不能省：写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/就失效 - URL 必须以
/结尾：用https://mirrors.aliyun.com/composer（缺斜杠）会导致路径拼成/composerpackages.json，404 且无提示
验证是否真写进去了：composer config -g repo.packagist。输出应为完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null 或报 Key 不存在，说明没写对。
项目级镜像配置覆盖全局设置怎么办
只要项目根目录的 composer.json 里有 repositories 字段，全局镜像就自动失效——这是 Composer 的设计逻辑，不是 bug。
检查方法很简单：composer config repo.packagist（不带 -g）。如果有输出，说明项目自己写了镜像；如果提示 Key 不存在，才轮到读全局。
常见陷阱：
- 哪怕
"repositories": {}这种空对象，也会触发“禁用默认源”，全局镜像完全不走 - 执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）会全量替换整个repositories字段，把你原有的私有 Git 源（如"my-private": {"type": "vcs", ...}）直接清空 - CI/CD 流水线或宝塔面板常用
www用户运行命令，而composer config -g默认写的是当前登录用户的配置，权限链断了
安全做法：手动编辑 composer.json，确保 repositories 是数组，首位放 {"packagist.org": false}，第二位才是镜像源，并保留其他自定义源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
换镜像后 composer install 报 hash 不匹配
这不是网络问题，是旧 composer.lock 文件里记录的包哈希和 dist URL 来自官方源，切换镜像后，Composer 仍按原路径去阿里云找 zip 包——但镜像服务的内部路径映射与 packagist.org 不同，校验必然失败。
必须做两件事：
- 删掉项目里的
vendor/目录 - 删掉
composer.lock文件 - 再执行
composer install（不是update），让 Composer 重新解析依赖、生成适配新镜像的 lock 文件
注意：composer update 会保留旧 lock 的约束，依然可能失败；只有 install 才强制重走完整流程。
怎么确认实际走的是镜像而不是 packagist.org
别信“命令执行成功”或“下载变快了”，那些都可能是缓存或元数据层面的假象。最可靠的方法是看真实请求日志。
执行：composer install -vvv，然后搜日志里的 GET https:// 行：
- 看到
mirrors.aliyun.com或你配的镜像域名 → 真走镜像 - 看到
packagist.org或api.github.com→ 镜像没生效，或只加速了元数据，zip 包仍绕路
尤其注意：镜像只加速 .zip 和 .tar 包下载，不参与 Resolving dependencies 阶段。如果卡在这里，问题出在 PHP 版本约束太宽、dev 分支太多或 require-dev 工具过多，跟镜像无关。
