Composer报“虚拟内存不足”实为PHP memory_limit被击穿，与缓存目录无关；最有效解法是php -d memory_limit=-1或2G前置调用，CI/CD中须设上限防OOM，且必须作用于真实PHP进程。
Composer 报“虚拟内存不足”不是缓存空间问题，而是 PHP 进程内存限制（memory_limit）被击穿——它和 Composer 缓存目录大小（cache-dir）完全无关。强行调大缓存不会缓解内存耗尽，反而可能让磁盘占满后触发系统级 OOM。
为什么改 cache-dir 或 cache-files-maxsize 没用
Composer 缓存（files/、repo/ 等）是磁盘存储，不占用 PHP 运行时内存；而 Allowed memory size exhausted 错误明确指向 RAM 不足。常见误解包括：
- 把“缓存写入失败”日志误读为“缓存空间不够”，实际可能是权限错误或路径不存在
- 执行
composer clear-cache后仍报内存错，误以为要“清空缓存腾内存”，但清理缓存本身也吃内存 - 在
composer.json里加"cache-files-maxsize": "2G"，这个配置只控制磁盘用量，PHP 根本不读它
php -d memory_limit 是最直接有效的解法
必须在调用 Composer 前显式提高 PHP 内存上限，且优先级高于 php.ini 和环境变量：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 本地开发可临时不限制：
php -d memory_limit=-1 composer install - CI/CD 或容器环境必须设上限（防 OOM）：
php -d memory_limit=2G composer update - Windows CMD 中注意引号：
php -d "memory_limit=-1" composer install - 确认你调用的是
php composer.phar，而非 shell 别名（别名会忽略-d参数）
COMPOSER_MEMORY_LIMIT 环境变量更轻量但有局限
这是 Composer 原生支持的机制，只影响自身依赖解析逻辑，不干扰其他 PHP 扩展：
- 临时生效（当前终端）：
export COMPOSER_MEMORY_LIMIT=2G（Linux/macOS）或set COMPOSER_MEMORY_LIMIT=2G（Windows CMD） - CI 脚本中推荐直接注入：
COMPOSER_MEMORY_LIMIT=2G composer install - 注意：它不能绕过 PHP 底层限制——若
php -i | grep "memory_limit"显示为 128M，则即使设了COMPOSER_MEMORY_LIMIT=-1，也会在 autoload 阶段崩溃
真正该检查的“缓存相关”陷阱
某些看似缓存的问题，实则是内存泄漏诱因：
-
vendor/autoload.php生成失败 → 往往因为autoload配置误扫了logs/、storage/或node_modules/下的巨型文件 - 启用了
xdebug→ 开发环境开着它会让 Composer 内存占用翻倍，临时关掉：php -d zend_extension= -d xdebug.mode=off composer install - Docker 容器内存不足 →
php -d memory_limit=3G无效，必须同步调高--memory=4g参数 - 旧版插件（如已废弃的
hirak/prestissimo）→ 即使加了--no-plugins，部分插件预加载行为仍残留，建议升级到 Composer 2.5+
最易被忽略的一点：php -d 必须作用于真正执行 Composer 的那个 PHP 进程。很多 CI 流水线默认用 composer install，背后其实是系统 PATH 里的 wrapper，它不接受 -d；必须显式写成 php /usr/bin/composer install 并在其前加参数。
