Composer全局镜像未生效主因是配置错误或缓存未清：键名必须为repo.packagist（单数），需带composer类型参数，URL须以https://开头且结尾含/；执行后需用composer config -g repo.packagist验证输出，再运行composer clear-cache并检查缓存目录为空；项目级repositories会覆盖全局配置，需用composer config repositories确认实际源；依赖解析慢与镜像无关，需优化稳定性、PHP版本约束及禁用xdebug。
composer config -g repo.packagist 输出为空或仍是 packagist.org？
说明配置根本没写进去，不是“慢”，是压根没生效。Composer 2.x 对键名、参数顺序、URL 格式极其敏感，错一个字符就静默忽略。
-
repo.packagist必须是单数，repos.packagist或repositories都无效 - 命令必须带
composer这个 type 参数：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须以
https://开头且末尾带/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出 404 路径） - 执行后立刻验证：
composer config -g repo.packagist应输出完整 JSON 或至少是有效 URL 字符串；空、null、或含packagist.org就得重配
composer install -vvv 日志里还在请求 packagist.org？
这不是镜像地址写错了，而是缓存还在用旧元数据。Composer 优先读 ~/.composer/cache/repo/ 里的 packages.json，哪怕你刚改完配置，只要缓存没清，它就继续往海外源发请求——直到超时才 fallback，卡几十秒是常态。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须执行：
composer clear-cache，不是可选项 - 清完后手动检查：
ls ~/.composer/cache/repo/应为空目录（Windows 是%APPDATA%\Composer\cache\repo\） - 临时验证是否真走新源：
composer install -vvv --no-cache，如果变快，就坐实是缓存问题 - 日志末尾出现
Reading packages.json from cache at /https---mirrors-aliyun-com-composer/才算真正生效
项目根目录有 composer.json 就一定绕过全局镜像？
是的。Composer 的配置优先级是：项目级 repositories > 全局 repo.packagist。只要 composer.json 里存在 "repositories" 字段（哪怕只是 {} 或 []），全局镜像就会被跳过。
- 查项目实际生效源：
composer config repositories（在项目目录下运行） - 重点看
"packagist.org": { "type": "composer", "url": "..." }这一项，它的url值才是真实请求地址 - 若项目需保留私有源，别用
composer config repo.packagist（会全量覆盖repositories），应手动编辑composer.json，确保结构类似：{"repositories": [{"type": "composer", "url": "https://mirrors.aliyun.com/composer/", "packagist": false}]} - 改完记得
composer update --lock，让composer.lock记录新源
Resolving dependencies 卡住几分钟，和镜像无关
镜像只加速下载环节（Fetching、Downloading），不解决依赖求解慢的问题。这个阶段纯 CPU 密集型计算，Composer 在本地暴力穷举所有满足约束的版本组合。
- 删掉
"minimum-stability": "dev"—— 稳定版能砍掉 80% 求解时间 - 收紧 PHP 版本约束：
"php": "^8.1"比"php": ">=7.4"少查几百个包的兼容性元数据 - 避免宽泛版本号：
"*"、"dev-main"、"^1.0 || ^2.0"都会让求解器爆炸 - 临时禁用 xdebug：
php -d xdebug.mode=off $(which composer) install，否则解析慢 5–10 倍
