Composer换源不生效的主因是：repo.packagist键名必须为单数、type值必须显式写composer、URL末尾必须带/，三者缺一即静默失效；且需执行composer clear-cache并验证config输出是否为完整JSON。
卡在 Downloading... 或 Resolving dependencies through SAT，90% 不是网络问题，而是镜像没生效、缓存没清、或本地配置冲突——先验证再调参。
composer config -g repo.packagist 为什么总不生效
不是命令输错，是三个硬性条件缺一不可：
-
repo.packagist必须是单数repo（不是repos或repositories），拼错就静默写进无效字段 - 命令末尾必须显式带上
composer类型标识，省略会导致 fallback 到https://packagist.org - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（路径拼接错误直接 404）
验证唯一方式：composer config -g repo.packagist 输出必须是 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或纯 URL 字符串。空、null、含 packagist.org，都说明没写对。
换了镜像，-vvv 日志里还在请求 packagist.org
Composer 有明确优先级：项目级 repositories > 临时 --repository > 全局 repo.packagist。只要项目 composer.json 里存在 "repositories" 字段（哪怕只是空数组），全局镜像就会被跳过。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查项目根目录的
composer.json是否含"repositories"；若有，确认其中是否显式添加了"packagist.org": false - 私有包、
path类型仓库、废弃包（abandoned）会绕过镜像，直连 GitHub 或官方源 - 镜像同步有延迟（通常 5–30 分钟），新发布的包可能尚未同步，可用
composer show vendor/package -vvv观察真实请求域名
vendor 安装仍慢？别只盯网络
换源后还卡在 installing xxx (v1.2.3)，大概率是本地环境或 lock 文件问题：
-
composer.lock里记录的是原始packagist.org的 dist URL，执行composer update --lock强制刷新下载链接 - 某些包启用了
dist+source双模式，镜像只代理 dist（ZIP），而 source（Git）仍直连 GitHub —— 这类包无法通过换镜像加速 - PHP 扩展缺失（如
openssl或curl版本过低）会导致 HTTPS 握手失败，表现为“超时”，实为协议层报错 - Composer 3.x 默认开启
classmap-authoritative，每次update都强制重扫整个vendor目录；关掉它：composer config authorative false（注意拼写是authorative）
parallel-downloads 和 --prefer-dist 怎么配才真提速
parallel-downloads 是 Composer 2.2+ 原生并发机制，但它只对 composer install 有效，对 composer update 几乎无加速作用——因为依赖图求解（SAT）本身是串行的。
- 全局启用：
composer config -g parallel-downloads 10；设为 20 容易触发file_put_contents(/tmp/): failed to open stream，8～10 更稳妥 -
--prefer-dist强制下载预打包 ZIP，跳过 Git clone 和源码编译，但仅当包提供 dist 地址才生效（多数主流包都提供） - 生产部署必加组合：
composer install --no-dev --prefer-dist --optimize-autoloader；开发阶段慎用，否则调试时找不到源码
最常被忽略的一点：换镜像后必须立刻跑一次 composer clear-cache，否则旧元数据仍会触发对官方源的请求——这不是可选项，是必要动作。
