Composer install卡在Downloading的根本原因是默认连接国外packagist.org导致DNS、TCP、TLS延迟高；必须全局更换为阿里云镜像源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，并执行composer clear-cache验证生效。
Composer install 卡在 Downloading 或长时间无响应？核心问题通常不是网络本身，而是默认源（packagist.org）的地理延迟、TLS握手开销，以及未启用并行下载和缓存机制。
换国内镜像源（最直接有效）
packagist.org 官方源对国内用户直连延迟高，DNS 解析慢，且不支持 HTTP/2。阿里云、腾讯云、华为云等镜像已同步全量包，延迟低、吞吐高。
- 临时切换（仅本次命令生效）：
composer install -vvv --repository=https://mirrors.aliyun.com/composer/ - 全局永久设置（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：运行
composer config -g repo.packagist，输出应为镜像 URL，而非https://packagist.org - 注意：某些企业内网会拦截非官方域名，若报
SSL certificate problem，需确认镜像站证书是否被信任（阿里云/腾讯云镜像均使用有效 Let's Encrypt 证书）
启用并行下载与跳过哈希校验
Composer 默认串行下载，并在校验每个包前先完整拉取 ZIP；开启并行 + 跳过校验可显著缩短感知耗时，尤其在 CI 环境或已有可信缓存时。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加参数启用并行：
composer install --prefer-dist --no-interaction --no-progress -n（--prefer-dist强制用 ZIP 包而非 Git 克隆） - 跳过哈希校验（仅限可信环境，如本地开发或私有 CI）：
composer install --no-scripts --no-plugins --ignore-platform-reqs，但更安全的做法是保留校验，改用COMPOSER_DISABLE_XDEBUG_WARN=1环境变量避免 Xdebug 拖慢 - 注意：
--skip-scripts不影响下载，但能减少安装后脚本执行时间；真正提速靠的是--prefer-dist+ 镜像源组合
复用 vendor 缓存（尤其 CI/CD 场景）
每次 composer install 从零拉包是最大浪费。vendor 目录本身不可缓存，但 Composer 的 ~/.composer/cache 可跨项目复用 ZIP 和 dist 包。
- 确保缓存目录可写：
ls -ld ~/.composer/cache，权限异常时用composer config -g cache-dir ~/.composer/cache显式指定 - CI 中建议挂载缓存目录（如 GitHub Actions 的
actions/cache），缓存路径为~/.composer/cache，key 可基于composer.lock的 hash 生成 - 手动清理旧缓存：
composer clear-cache，但不要频繁执行——缓存命中率下降反而拖慢后续 install - 注意：不同 PHP 版本或平台要求（如
ext-gd）可能导致缓存包不可复用，此时 Composer 会自动 fallback 到重新下载
检查 lock 文件是否被意外修改
composer install 应严格按 composer.lock 安装。如果 lock 文件被手工编辑、Git 合并冲突残留或 IDE 自动格式化，会导致 Composer 重新解析依赖树，触发大量远程查询和重下载。
- 验证 lock 文件完整性：
composer validate --strict，报错则说明格式或哈希不匹配 - 对比 lock 与当前依赖是否一致：
composer update --dry-run，若输出大量“would update”，说明 lock 已过期或不一致 - 常见坑：IDE（如 PHPStorm）默认启用 “Sort composer.json on save”，会重排键顺序，导致 Git diff 失真，建议关闭该选项或用
composer normalize统一格式
真正卡住的往往不是带宽，而是 DNS、TLS 握手、单线程阻塞、缓存失效或 lock 文件漂移。镜像源 + --prefer-dist + 缓存复用这三者配齐，90% 的慢 install 场景都能回落到秒级完成。别忘了检查 composer.lock 是否干净——它比你想象中更容易悄悄坏掉。
