Composer install慢、卡住主因是镜像未生效、缓存目录不可写或platform.php版本不匹配；须验证config -g repo.packagist输出完整JSON、cache-dir可写、platform.php与php -v一致，否则触发伪离线行为。
composer install 速度慢、卡住、反复重试，不是网络差，而是本地配置没对齐镜像源、缓存路径和平台约束。
为什么 composer install 在 macOS 上特别慢或失败
常见现象包括：卡在 Downloading https://api.packagist.org/、反复 retry、某包下载超时、同一项目在 CI 或 WSL 中快得多。根本原因不是“Mac 网络差”，而是：
- 全局镜像未生效（
repo.packagist配置写错或漏斜杠） - 缓存目录被设为不可写（比如
COMPOSER_HOME指向权限受限路径） - PHP 平台版本不一致（如本地 PHP 8.2，但
composer.json写了"platform": {"php": "8.1"}，触发模拟降级+额外解析） - Homebrew 安装的 PHP 扩展缺失（如
curl、openssl、zlib），导致 HTTP 请求失败但报错不明显
必须验证的三项关键配置
运行以下三行命令，任一结果异常都会拖慢 composer install：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer config -g repo.packagist→ 应输出完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（注意末尾斜杠） -
composer config -g cache-dir→ 建议为/Users/yourname/.composer/cache，且该路径需可写：ls -ld $(composer config -g cache-dir) -
composer config -g platform.php→ 若为空则走本地 PHP 版本；若非空，需与php -v输出严格一致，否则触发平台模拟逻辑
加速 install 的实操开关（非镜像）
除了换源，这些参数能跳过非必要步骤，适合开发机或 CI 场景：
- 加
--no-scripts：跳过post-install-cmd等钩子（如生成 autoload、清缓存），适合只拉依赖不执行初始化 - 加
--no-plugins：禁用所有全局插件（如hirak/prestissimo已废弃，新版 Composer 自带并发，插件反而冲突） - 加
-n（即--no-interaction）：避免卡在交互式提示（如私有包认证） - 确保
composer.lock存在且未被修改：这是最快路径；若缺失或改动，Composer 会退化为update行为，重新解析整个依赖图
Homebrew PHP 下容易被忽略的权限陷阱
M1/M2 Mac 上，brew install php 默认装在 /opt/homebrew/bin/php，但某些扩展（如 apcu、redis）需手动启用，否则 composer install 过程中某些包的脚本会静默失败：
- 检查是否启用
curl：运行php -m | grep curl，若无输出，执行brew install curl并确认extension=curl在php.ini中未被注释 -
openssl和zlib同理，缺一则 HTTPS 请求可能 fallback 到低效路径甚至中断 - 验证方式：运行
php -r "echo file_get_contents('https://mirrors.aliyun.com/composer/packages.json') ? 'ok' : 'fail';"，输出ok才算底层网络栈真正就绪
最常被跳过的验证点是 cache-dir 权限和 platform.php 是否匹配——这两项不报错，但会让 install 变成“伪离线”行为：看似在装，实则反复解析、重建锁文件、绕过缓存。跑完 composer install -vvv 最后几行如果出现 Reading /.../cache/repo/https---mirrors-aliyun-composer/provider-xxx.json from cache，才算真正走通高速路径。
