Composer 内存限制怎么设？别被那些“配置项”骗了
先说一个常见的误区：很多人以为 Composer 有个叫 memory-limit 的配置项，可以直接用 composer config 设置。但真相是——Composer 根本没有这个系统参数。它既不提供类似的 config 命令，也不读 composer.json 里的相关字段。所有试图用 composer config memory-limit 或在 config 段写 "memory-limit": "-1" 的做法，一概无效。
Composer 其实根本没有“运行内存限制”这个配置项——你找不到类似的内置配置，composer config memory-limit这条命令根本不存在，写进去也是无效的。唯一可行的办法，要么设环境变量COMPOSER_MEMORY_LIMIT，要么用 PHP 启动参数php -d memory_limit=-1。
为什么 composer config memory-limit 不起作用
这个命令压根不存在。Composer 的 config 子命令根本不识别 memory-limit，执行后既不报错也不写入任何配置——纯粹是误导。官方文档和源码里都找不到对这个字段的支持。你看到的那种“好像生效了”的情况，大概率是巧合（比如刚好同时设了环境变量），或者误判了错误消失的真正原因。
composer config -g memory-limit -1：静默失败，全局配置文件里不会出现这个字段。- 在
composer.json里写"config": { "memory-limit": "-1" }：Composer 启动时直接忽略，完全不解析。 - 真正被读取的只有环境变量
COMPOSER_MEMORY_LIMIT，或者 PHP 启动参数-d memory_limit。
COMPOSER_MEMORY_LIMIT 怎么设才合法且生效
这是 Composer 原生支持、优先级最高的方式，但值必须严格符合格式，否则会被当成字符串直接丢弃。
- 正确写法：
COMPOSER_MEMORY_LIMIT=-1（不限制）、COMPOSER_MEMORY_LIMIT=2147483648（2G 字节）、COMPOSER_MEMORY_LIMIT=2G（仅 PHP 7.2+ 支持，推荐 Linux/macOS 用户用这个）。 - 错误写法：带引号的
"-1"、小写的2g（大小写敏感）、旧版 Composer 不认2048M这种带单位的写法、COMPOSER_MEMORY_LIMIT=0（这不是禁用，而是 fallback 到 php.ini）。 - 平台差异：
Linux/macOS：直接COMPOSER_MEMORY_LIMIT=2G composer install
Windows CMD：set COMPOSER_MEMORY_LIMIT=2G && composer install
PowerShell：$env:COMPOSER_MEMORY_LIMIT="2G"; composer install
php -d memory_limit 和 COMPOSER_MEMORY_LIMIT 的关键区别
两者控制层级不同，不能互相替代。
php -d memory_limit=-1是 PHP 解释器的硬闸门，限制整个进程（包括 fork 出的子进程、解压、脚本执行等），优先级更高。COMPOSER_MEMORY_LIMIT只影响 Composer 主进程内部逻辑（比如依赖图解析、缓存构建），对unzip、git clone等子进程无效。- 同时设置时，
php -d优先生效；如果只设了COMPOSER_MEMORY_LIMIT=-1，但 PHP 层面php -d memory_limit=128M，依然会报Allowed memory size exhausted。 - 在 Docker/CI 环境中，
php -d经常被安全策略禁用，这时候只能靠COMPOSER_MEMORY_LIMIT来兜底。
调高了还是 OOM？真凶往往不是内存数值本身
就算你把内存上限设到 4G，仍然失败的话，说明问题出在行为模式上，而不是容量不够。
- 启用了 xdebug：CI 中务必关掉，用
php -m | grep xdebug确认一下。它能让内存占用翻倍甚至更多。 - autoload 规则过宽：比如
"psr-4": {"" : "src/"}这种写法，实际会扫描 vendor 目录下的内容；或者autoload.files引入了超大工具文件。 - composer.lock 文件过大（超过 5MB）：常见于
"minimum-stability": "dev"或大量dev-master提交哈希堆积。可以考虑清理require-dev。 - 用了已废弃的插件或老版本 Composer：比如
fxp/composer-asset-plugin，或者 Composer 版本低于 v2.2。升级到 v2.5+ 能明显缓解。
最麻烦的是环境之间的配置没对齐——本地用 php -d 过了，CI 里只设了 COMPOSER_MEMORY_LIMIT 却忘了关 xdebug，结果卡在同一个位置。这种隐性不一致，比数值本身更难排查。
