composer命令执行慢90%非本身问题，而是镜像未生效、缓存未清、配置错误或权限不当；需执行config -g三命令并clear-cache验证。
Composer 命令执行慢，90% 的情况不是 Composer 本身有问题，而是环境配置、网络或命令用法不匹配当前场景。直接上有效解法，不绕弯。
为什么 composer install 有时比 composer update 还慢
按设计，composer install 应该极快——它只读 composer.lock 并解压 vendor。但以下情况会让它卡住：
- 启用了已废弃插件（如
fxp/composer-asset-plugin或残留的全局插件），触发额外元数据请求 - 镜像源不可用，fallback 到
packagist.org，TLS 握手 + DNS 解析拖慢首请求 -
vendor/目录存在但部分包损坏，Composer 会逐个校验完整性（尤其启用--prefer-dist时） - PHP OPcache 未启用，或
opcache.validate_timestamps=1导致每次加载 autoloader 都stat()文件
验证是否为网络问题：加 -vvv 参数运行，重点关注 Downloading https://.../packages.json 日志卡在哪一步。
composer install 生产部署必须带的三个参数
在 CI/CD 或生产服务器上跑 composer install，漏掉任意一个都可能白优化：
-
--no-dev：跳过require-dev包，不生成它们的 autoload 规则，classmap 体积更小、反序列化更快 -
--optimize-autoloader（简写-o）：生成vendor/composer/autoload_classmap.php，避免运行时文件扫描 -
--classmap-authoritative（简写-a）：告诉 autoloader “所有类都在 classmap 里”，彻底禁用 PSR-4 动态查找路径
注意：composer dump-autoload -o 在 Composer 2+ 中已失效——它不重建 classmap，也不保证覆盖全部类，线上用这个大概率报 Class not found。必须用 install 或 update 命令触发完整扫描。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
国内镜像源配置与缓存隔离
默认走海外源是 M1/M2 Mac、CentOS、Docker 构建中最常见的性能瓶颈。配置需满足两个硬性条件：
- 全局生效且格式正确：运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（URL 末尾必须有/，type 必须是composer） - 缓存目录不能落在 NFS、Docker volume 或 VirtualBox 共享目录上：设置
COMPOSER_CACHE_DIR=/tmp/composer-cache或composer config --global cache-dir /tmp/composer-cache
验证是否生效：composer config -g repo.packagist 输出应为 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。别信 composer diagnose，它不显示 repo 配置。
Docker 构建中 vendor 缓存失效的典型错误
很多人写 Dockerfile 时把代码和依赖一起 COPY，导致每次改一行 PHP 就重装全部 vendor：
- ❌ 错误写法：
COPY . . && RUN composer install --no-dev -o -a - ✅ 正确写法：先 COPY
composer.json和composer.lock，再 RUN install，最后 COPY 其他代码
同时，在 docker-compose.yml 中挂载本地缓存目录：volumes: - ~/.composer/cache:/root/.composer/cache，避免重复下载。
最常被忽略的一点：优化后一定要检查 vendor/composer/autoload_real.php 里的 findFile() 方法——如果还保留着 foreach ($this->prefixesPsr4 循环，说明 --classmap-authoritative 根本没生效，classmap 可能漏类或命令没跑对。
