--apcu-autoloader 在 cli 下无效，因其依赖进程复用，而 cli 每次执行均为新进程，缓存随进程销毁；仅 php-fpm 或 mod_php 环境有效，且需 apc.enabled=1、apc.enable_cli=0，并通过 php -r "var_dump(apcu_enabled());" 验证。
为什么 --apcu-autoloader 在 CLI 下常无效果
它根本不是为 CLI 设计的加速机制。APCu 缓存依赖进程复用，而 CLI 每次执行 php composer install 都是全新进程，apcu_store() 写入的缓存立刻随进程销毁——所以你在终端里跑 composer install --apcu-autoloader，命令能成功，但后续 Web 请求完全读不到缓存。
真正生效的场景只有：PHP-FPM（推荐）或 Apache mod_php；apc.enable_cli=0 是必须的（CLI 下禁用 APCu 用户缓存，避免干扰），FPM 下则需 apc.enabled=1 且未被 ini_set() 禁用。
- 验证是否可用：运行
php -r "var_dump(apcu_enabled());"，FPM worker 中返回true才算到位 - 别信
php -m | grep apcu—— 扩展加载 ≠ 用户缓存启用 - 若用 Docker，确认 php.ini 中
apc.shm_size≥ 32M（默认 32M 常不够，大型项目建议 64M）
哪些 Composer 命令真正触发 APCu 缓存写入
--apcu-autoloader 不是运行时开关，而是“生成阶段”参数，只在构建自动加载器时起作用。它不改变已存在的 vendor/autoload.php，只影响新生成的加载逻辑。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 有效命令：
composer install --apcu-autoloader --no-dev --optimize-autoloader（部署首选） - 有效命令：
composer dump-autoload --apcu-autoloader --classmap-authoritative（开发中改了类名后重刷） - 无效组合：
composer install --apcu-autoloader+ 后续composer dump-autoload（无参）——后者会覆盖掉 APCu 版本，降级回纯文件映射 - 更新依赖时必须显式加参数：
composer update --apcu-autoloader，否则缓存不会刷新
缓存写入失败的三个隐藏原因
即使命令执行成功、APCu 扩展开着，缓存也可能压根没写进去，或写进去后立刻被驱逐。
-
"optimize-autoloader": true未启用：该配置必须存在于composer.json的config段（不是autoload），否则--apcu-autoloader被直接忽略 -
apc.shm_size过小：缓存满时新映射写不进，APCu 自动降级，apcu_cache_info('user')['num_entries']接近上限就危险 -
composer.json 或 PHP 版本变更后未重装：旧 APCu 缓存键仍存在，但映射已失效，导致
Class not found—— 此时要先apcu_clear_cache('user')再重跑 install
怎么确认 APCu 缓存真正在工作
不能看命令是否成功，得查运行时行为。Web 请求里调用 APCu API 才算数。
- 临时加一行：
var_dump(apcu_exists('ComposerAutoloadNspMap'));放在入口脚本开头，返回true表示命中 - 查命中率：
apcu_cache_info('user')['num_hits']应随请求增长，num_misses增长缓慢 - 手动清空对比：
apcu_clear_cache('user')后首屏加载时间明显变长，说明之前确实在用缓存 - 注意：
opcache_get_status()里的 hit rate 和 APCu 无关，那是 OPCache 的统计
