Composer安装慢的核心是依赖解析、网络下载、自动加载器生成三阶段叠加，需分阶段优化：先验证镜像源是否生效（composer config -g repo.packagist输出必须为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}），再强制使用--no-dev --optimize-autoloader --prefer-dist参数组合，最后排查Resolving dependencies卡顿是否由Xdebug、内存不足或platform配置不匹配导致。
Composer 导出（composer install 或 composer update）慢，核心问题不是“导出”本身耗时，而是依赖解析、网络下载、自动加载器生成三个阶段叠加导致。真正有效的加速，必须分阶段击破。
确认当前镜像源是否生效
90% 的“卡在 downloading”问题都源于镜像没切对。别只看 composer.json 里的 repositories —— 它只影响当前项目，且会被全局配置覆盖。
- 运行
composer config -g repo.packagist，输出必须是类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果返回空、
null或仍是https://packagist.org，说明未生效 - 旧版 Composer（1.x）需用
composer config -g repos.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}' - 加
-vvv运行一次composer install，日志里出现的域名必须是mirrors.aliyun.com才算真正走镜像
生产环境必须加 --no-dev --optimize-autoloader --prefer-dist
这组参数组合不是“可选优化”，而是生产部署的事实标准。单独漏掉任何一个，都可能让安装时间翻倍。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--no-dev：跳过require-dev下所有包（如 PHPUnit、php-cs-fixer），减少约 50% 文件量 -
--optimize-autoloader（或-o）：生成vendor/composer/autoload_classmap.php，避免运行时目录扫描；纯 PSR-4 项目提升有限，但 Laravel 等混合结构项目收益明显 -
--prefer-dist：强制下载 ZIP 包而非 Git 克隆，压缩包体积小、校验快、CDN 友好；Composer 2.2+ 默认启用，但显式声明更稳妥 - 注意：
composer install不会读取composer.json中的"optimize-autoloader": true，必须显式传参
解决 Resolving dependencies 卡顿
这个阶段不走网络，但极易被误判为“网络慢”。实际是 PHP 解析器在内存中构建依赖图，受环境干扰极大。
- 检查是否启用了 Xdebug：
php -v输出含xdebug就要禁用，临时运行：php -d xdebug.mode=off $(which composer) install - 内存不足常见于 CI 环境，默认
memory_limit=128M不够，加环境变量：COMPOSER_MEMORY_LIMIT=-1 - 确认
platform配置与实际 PHP 版本匹配，例如"php": "8.2"却在 PHP 8.3 上跑，会触发降级回溯逻辑 -
composer.lock若含已下线包（如 Packagist 移除的老版本），也会在此阶段反复重试；可删掉vendor/和composer.lock后重试
缓存复用和 Docker 场景要点
本地开发或 CI 中，缓存没挂对等于白调优。关键不是“有没有缓存”，而是“缓存路径是否稳定、是否跨项目共享、是否被清理”。
- 手动指定缓存目录：
composer config -g cache-dir "$HOME/.composer/cache"，避免默认路径被 CI 清理 - Docker 中务必挂载：
volumes: - ~/.composer/cache:/root/.composer/cache，否则每次docker-compose run都是全新缓存 - CI 中应缓存
~/.composer/cache和vendor/目录（后者需配合composer install --no-dev确保一致性） - 不要用已弃用的
parallel-downloads，改用composer config -g http-max-concurrent-downloads 10
最常被忽略的一点：优化后首次 composer install 仍可能稍慢——那是它在拉取镜像源的完整元数据包（packages.json），后续所有操作才真正快起来。别在第一次就判定优化失败。
