Composer 2.x 配置镜像需严格满足三要素：全局参数-g、键名repo.packagist、type值为composer且URL末尾带/，否则静默回退官方源；项目级应使用composer config repo.packagist composer https://mirrors.aliyun.com/composer/自动合并，改后清缓存并重装。
composer config -g repo.packagist 命令为什么没生效
不是网络慢，是配置根本没写进去——Composer 2.x 对 repo.packagist 的键名、type 值、URL 格式三者要求极严，漏一即静默回退到 https://packagist.org，不报错也不提示。
必须同时满足：
-
-g参数不能省，否则只改当前目录的composer.json，换项目就失效 - 键名必须是
repo.packagist（单数repo，不是repos.packagist或packagist.org） -
composer是强制 type 值，不是可选参数，也不能写成composer-type或省略 - URL 必须是 HTTPS，且末尾带
/，https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/composerpackages.json导致 404）
验证是否成功：运行 composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或纯 URL 字符串。如果返回空、null、或仍是 https://packagist.org，说明没写对。
项目级镜像配置如何避免覆盖私有仓库
全局配置在 CI、宝塔、Docker 等多用户环境中不可靠，项目级配置才是协作刚需。但手动编辑 composer.json 极易破坏 JSON 格式或误删已有源。
安全做法是用命令自动合并：
- 进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 如果原
composer.json中"repositories"是空对象{}，命令会转为标准数组并插入 packagist 条目 - 如果已是数组（如含私有包源），命令会在末尾追加新项，不覆盖原有内容
- 切勿手动写
"packagist": false—— 这会导致php、ext-json等基础平台约束校验失败
改完后务必删掉 vendor/ 和 composer.lock，再跑 composer install（不是 update），否则旧 lock 文件仍走官方源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
缓存清理和镜像回退机制必须配合使用
镜像只加速下载，不解决依赖解析慢；而缓存若残留旧源元数据，会掩盖镜像是否真生效。
换源后必须执行：
-
composer clear-cache：清掉本地已缓存的packagist.org元数据（如packages.json），否则 Composer 仍可能从旧缓存读取过期信息 - 确认新版 Composer 2.2+ 的 fallback 机制未被关闭：
composer config -g repos.packagist应为true（默认开启），不要手动设为false—— 镜像同步有延迟（通常 ≤15 分钟），fallback 是兜底保险丝 - 调试时加
-vvv：如composer install -vvv，日志里会明确打出实际请求的 URL，一眼识别是否真走mirrors.aliyun.com
缓存路径本身也影响速度：默认缓存在用户目录下，若该目录在机械硬盘或 NFS 挂载点，I/O 成瓶颈。可考虑迁至 SSD 路径，通过 composer config -g cache-dir /path/to/ssd/cache 调整。
composer update 卡在 Resolving dependencies 和镜像无关
镜像生效后，Downloading 阶段明显变快，但 composer update 仍卡在 Resolving dependencies 几十秒甚至几分钟？这和镜像完全无关，是本地解析逻辑问题。
常见诱因：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，让 Composer 尝试大量 PHP + 扩展组合 -
require-dev里塞了太多未锁定的工具包（如"phpunit/phpunit": "dev-main"） - 本地
config.platform.php与composer.json中声明的 PHP 版本不一致，触发重复兼容性检查 -
xdebug未关闭：它会显著拖慢依赖图遍历，php -d xdebug.mode=off -d memory_limit=-1 $(which composer) update可验证
这类问题无法靠换源解决，得收紧约束、清理 dev 包、关掉 xdebug、或用 --with-all-dependencies 限制解析范围。
