COMPOSER_MEMORY_LIMIT环境变量仅作用于Composer自身内存预检逻辑，对PHP底层“Allowed memory size exhausted”错误无效；它只在Composer主动报出“Not enough memory, need XXX more”时生效，属预防性提示而非兜底方案。
COMPOSER_MEMORY_LIMIT 环境变量到底管不管用
它只在 Composer 自己的内存估算逻辑里起作用，对 PHP 底层的 Allowed memory size exhausted 错误完全无效。当错误信息里明确出现 “bytes exhausted”，说明 PHP 进程已经 OOM，Composer 根本没机会读到这个环境变量。
这个变量真正生效的场景是：Not enough memory, need XXX more —— 这是 Composer 主动检查后抛出的提示，属于预防性拦截，不是兜底方案。
常见误操作：
- 设了
COMPOSER_MEMORY_LIMIT=-1却还报Allowed memory size exhausted，误以为配置失败，其实是 PHP 层早崩了 - 在 CI 脚本里只写
COMPOSER_MEMORY_LIMIT=2G composer install，没加php -d，结果照样失败 - Windows PowerShell 中漏掉引号，写成
php -d memory_limit=-1→-被当成命令选项解析，报错
Linux/macOS 和 Windows 下设置方式差异
环境变量本身跨平台一致，但 shell 解析行为不同，直接决定是否生效。
Linux/macOS（bash/zsh）：
- 临时：运行
COMPOSER_MEMORY_LIMIT=2G composer install - 永久：追加
export COMPOSER_MEMORY_LIMIT=2G到~/.zshrc或~/.bashrc，再执行source ~/.zshrc
Windows CMD：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时：运行
set COMPOSER_MEMORY_LIMIT=2G && composer install - 注意：
=前后不能有空格，否则变量不被识别
Windows PowerShell：
- 必须用
$env:COMPOSER_MEMORY_LIMIT="2G"，且该变量仅对当前会话有效 - 更稳妥的做法是绕过环境变量，直接用
php -d "memory_limit=-1" composer install
CI/CD 中为什么推荐 php -d 而非 COMPOSER_MEMORY_LIMIT
GitHub Actions、GitLab CI 等环境默认使用轻量 PHP 镜像，memory_limit 常被硬设为 128M，且不继承用户 shell 的环境变量。此时仅设 COMPOSER_MEMORY_LIMIT 不会改变 PHP 进程限制。
实操要点：
- GitHub Actions：在
run:步骤中显式调用php -d memory_limit=2G composer install - GitLab CI：路径要写全，比如
php -d memory_limit=2G /usr/bin/composer install - Docker 环境：除了 PHP 层，还得确认容器内存充足，例如
docker run --memory=4g - 别依赖
composer/setup-phpAction 的默认配置——它可能没开 memory-limit，要显式传memory-limit: 2G
什么时候该用 -1，什么时候该用具体数值
-1 表示无上限，本地调试快，但生产或 CI 场景下风险高：一旦依赖冲突触发指数级回溯，内存会无节制暴涨，可能拖垮 runner 或触发系统 OOM killer。
更稳的选择是固定上限：
- 普通 Laravel/Symfony 项目：设
2G足够覆盖绝大多数composer install和dump-autoload - 含大量
require-dev的单体项目（如含 PHPUnit + Pest + Pint + Dusk）：建议3G，尤其跑composer update时 - CI 流水线中多个 job 并发：统一设
2G，避免某次异常占用全部宿主机内存
注意：php -d memory_limit=2G 中的 2G 是 PHP 语法，不能写成 2048M 或 2000M —— 后者会被截断或解析失败。
