composer config -g repo.packagist 命令需同时满足三条件才生效：键名为 repo.packagist（非 repos）、第二参数指定 composer 类型、url 必须为 https 且末尾带斜杠；否则静默失败，配置未写入。
composer config -g repo.packagist 命令为什么总不生效
命令静默失败，不是报错，而是根本没写进配置——这是最常被忽略的致命点。必须同时满足三个硬条件：repo.packagist（不能是repos.packagist）、中间composer作为type值、URL末尾带斜杠且为HTTPS。
-
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/✅ 正确写法 -
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/❌ 多一个s，完全忽略 -
composer config -g repo.packagist https://mirrors.aliyun.com/composer/❌ 缺少composertype，fallback回默认源 -
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer❌ 少斜杠，请求404，卡在TLS握手
验证是否成功，只看这一条：composer config -g repo.packagist。输出必须是完整JSON对象或明确URL字符串；空、null、或仍是https://packagist.org，说明没写进去。
换镜像后composer install还是慢，该清哪些缓存
镜像配置对了，但composer clear-cache没执行，Composer仍从旧缓存读元数据——它甚至不会尝试新镜像地址，直接卡在DNS解析或TLS握手阶段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须运行
composer clear-cache，清除~/.composer/cache/下所有内容 - 项目级加速还需删掉
vendor/和composer.lock再重装，否则lock文件里仍记录着旧源哈希 - CI/CD中若用Docker，每次构建前应确保缓存目录挂载正确，避免每次都是“全新缓存”
- 宝塔或www用户运行时，
composer clear-cache必须用对应用户执行：sudo -u www composer clear-cache
parallel-downloads=10 和 --prefer-dist 怎么配合才有效
--prefer-dist本身不加速，它只是告诉Composer优先下载ZIP包；但国内镜像（如阿里云）几乎不缓存Git source，只缓存dist——如果镜像没切成功，--prefer-dist反而会fallback到极慢的source下载，甚至失败。
- 先确保
composer config -g repo.packagist已指向国内镜像，再设并发：composer config -g parallel-downloads 10 -
parallel-downloads仅对composer install生效，且要求Composer 2.2+ - 项目
composer.json中若存在"prefer-source": true，会全局覆盖--prefer-dist，必须手动删掉 - 并发数设太高（如20）可能触发镜像限流，10是实测稳定上限，尤其搭配阿里云/腾讯云镜像
项目级镜像配置怎么不破坏私有仓库
直接编辑composer.json里的repositories字段风险极高：JSON格式错一位、引号漏一个，整个composer install就中断。正确做法是让Composer自动合并。
- 进项目根目录，执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 这条命令会智能判断
repositories结构：空对象→转数组；已有数组→追加新项；不碰已有私有源 - 千万别写
"packagist": false，会导致php、ext-json等基础包校验失败 - 改完必须运行
composer update --lock，否则composer.lock仍按旧源生成，下次install不会走新镜像
镜像只解决下载瓶颈，不缓解Resolving dependencies卡顿——那通常是composer.lock缺失、minimum-stability设为dev、或本地PHP版本与config.platform.php不匹配。这些得另查，跟镜像无关。
