全局镜像配置需同时满足三个硬性条件才生效：repo.packagist 不能多写 s、必须包含 type 字段值 composer、URL 末尾必须带斜杠；否则仍走官方源。
全局镜像配置一条命令就能生效，但90%的人配不成功——不是网络问题，是命令写错了三个硬性条件。
composer config -g repo.packagist 命令为什么没生效
执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后仍卡在 Downloading xxx，大概率是以下任一条件未满足：
-
repo.packagist写成repos.packagist（多一个s），Composer 完全忽略该配置，不报错也不提示 - 漏掉中间的
composer——它不是注释或可选参数，而是type字段值，缺了就 fallback 到官方源 - URL 末尾没斜杠：
https://mirrors.aliyun.com/composer❌ 会拼出/composerpackages.json导致 404；必须是https://mirrors.aliyun.com/composer/✅
验证是否真写入：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错或只返回 URL 字符串，都说明配置失败。
项目级配置比全局更可靠，尤其适合 CI/CD 和团队协作
全局配置对宝塔、GitHub Actions、GitLab CI 等环境基本无效——它们以 www 或 runner 用户运行，读不到你本地用户的 ~/.composer/config.json。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 这条命令会自动向
composer.json的repositories字段追加"packagist"条目，不破坏原有私有源结构 - 如果
repositories已是数组，它会安全插入新项；如果是对象，它会转为标准数组格式 - 改完务必删掉
vendor/和composer.lock，再运行composer install（不是update），否则旧 lock 文件仍指向官方源
parallel-downloads 设了为啥还是串行下载
parallel-downloads 只在 Composer 2.2+ 才真正起作用，旧版本设了也白搭：
- 先确认版本：
composer --version；低于2.2.x必须升级：composer self-update --prefer-dist - 默认值是
3，等于没开并发；建议设为10：composer config -g parallel-downloads 10 - 并发过高可能触发临时文件竞争，报错
file_put_contents(/tmp/): failed to open stream，此时立刻降到6或8 - 注意：
parallel-downloads仅对composer install生效，且严重依赖镜像源支持 HTTP/2；若镜像未生效，它连并发机会都没有
--prefer-dist 被悄悄覆盖导致加速失效
--prefer-dist 是提速关键，但它会被项目级 composer.json 中的 "prefer-source": true 强行覆盖：
- 检查方法：在项目根目录执行
grep -r "prefer-source" .或直接搜索该字段 - 修复方式：
composer config --unset prefer-source，或手动删掉该字段 - 私有包若只提供 Git 地址（无 dist 包），
--prefer-dist会报错Could not find a matching version of package xxx，此时只能关掉该参数，或补全 dist 发布流程 - 国内镜像（如阿里云）只缓存 dist 包，不缓存 source；镜像失效时，
--prefer-dist会降级为慢速 Git clone，反而更卡
最易被忽略的一点：镜像只加速元数据拉取和 ZIP 下载，不解决 Resolving dependencies 卡顿——那通常是 PHP 版本约束太宽、dev 包未锁定、或 require-dev 塞了太多工具导致的解析爆炸，和镜像配置无关。
