composer中文环境报错中断95%非内存泄漏，而是php cli被memory_limit截断叠加realpath缓存bug；应优先用php -d "memory_limit=-1" composer install，并配合--no-dev、-o等参数优化。
Composer 在中文环境下报错中断，95% 不是“内存泄漏”，而是 PHP CLI 进程被 memory_limit 硬性截断——尤其在 Windows 中文路径、含中文 vendor 名或 autoload 扫描中文文件名时，realpath 缓存膨胀 + 默认 128M 限制双重叠加，导致卡死在 Resolving dependencies 阶段。
为什么中文环境更容易触发 OOM？
PHP 的 realpath_cache 在处理中文路径（如 D:\项目\tp6）时，会为每个路径生成独立缓存条目，且某些 PHP 版本（如 8.1.10、8.2.0–8.2.3、8.3.0）存在缓存不自动清理的 Bug。反复执行 composer install 或 dump-autoload 时，realpath_cache_size() 持续上涨，最终撑爆内存。
- 验证方式：
php -r "echo realpath_cache_size();"，多跑几次，数值递增就是它 - 不是 Composer 的锅，但表现和内存泄漏一模一样
- Windows 下 PowerShell 默认 UTF-8 输出，CMD 则可能乱码漏判，务必用 PowerShell 查
php -d memory_limit 必须写对格式才生效
这是唯一能绕过默认限制、立即起效的方式，但细节错一个就白忙：
- 顺序不能颠倒：
php -d memory_limit=-1 composer install✅；composer install -d memory_limit=-1❌ - PowerShell 必须加双引号：
php -d "memory_limit=-1" composer install（否则-1被 shell 当作参数丢弃） - 单位必须大写：
2G✅；2g❌（PHP 直接忽略，退回到 php.ini 默认值） - 用了
./composer.phar？写法不变：php -d memory_limit=2G ./composer.phar update
--no-dev 和 --optimize-autoloader 是真减压，不是硬扛
光提内存只是托底，真正省内存要砍掉不必要的解析逻辑：
-
--no-dev：跳过require-dev全部包（如phpunit、phpstan），降内存峰值 40%~60% -
--optimize-autoloader（或-o）：生成 classmap，避免运行时扫描中文目录下的.php文件，大幅降低 autoload 阶段压力 -
--classmap-authoritative：配合-o使用，让 autoloader 完全信任 classmap，不再 fallback 查文件——但漏类会 fatal error，慎用于开发中频繁增删类的场景 - CI/CD 推荐组合：
php -d memory_limit=2G composer install --no-dev -o --classmap-authoritative
别碰 COMPOSER_MEMORY_LIMIT=-1 当主力方案
这个环境变量常被误传为“Composer 内存开关”，但它只控制 Composer 自身少数可中断逻辑（比如依赖回溯步数），完全无法突破 PHP 底层 memory_limit：
- 即使设了
COMPOSER_MEMORY_LIMIT=-1，只要 PHP 进程本身被memory_limit=128M卡住，照样报Allowed memory size of 134217728 bytes exhausted - 它优先级低于
php -d，高于php.ini，适合做第二道防线（比如 CI 中设COMPOSER_MEMORY_LIMIT=1800M防插件失控） - Windows CMD 写法：
set COMPOSER_MEMORY_LIMIT=-1 && composer install；PowerShell：$env:COMPOSER_MEMORY_LIMIT="-1"; composer install
最容易被忽略的是：中文路径下 composer.lock 文件若含大量 dev-master 提交哈希或废弃包残留，体积超 3MB 后，install 反而比 update 更吃内存——此时删 lock 文件 + --no-dev 比单纯提内存更有效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
