APCu autoloader 不会自动启用，必须在 composer install 或 update 时显式添加 --apcu-autoloader 和 --optimize-autoloader 参数，并确保 PHP CLI 模式下 apc.enabled=1、apc.enable_cli=1、apc.stat=0 均生效，否则静默降级为文件加载。
APCu autoloader 不会自动启用，哪怕
扩展已装、
已跑完，只要没在正确时机用对参数，它就完全不工作——生成的
里压根没有
调用。
composer
install/update 必须带 --apcu-autoloader
这个参数只在
或
时有效，
不识别它，加了会报错
。
必须显式加上两个短横线：
如果
已存在且
是旧版（无 APCu 逻辑），该命令不会覆盖——得先删掉
或加
避免触发残留脚本
默认不继承上次的参数，每次都要重加
--optimize-autoloader 必须同时启用
单独加
没用：APCu 缓存的是“类名→路径”的映射表，而这张表只有开启优化后才会被完整生成；否则
几乎为空，缓存写了个寂寞。
等效于在
中配置：
推荐组合命令：
漏掉
，
返回
是常态
PHP 配置必须满足三个硬条件
APCu autoloader 在 CLI 下静默失效是高频问题，根源不是 Composer，而是 PHP 进程无法访问用户缓存。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
（值必须是数字
，不是
）
（CLI 模式下必须开，否则
阶段就写不进 APCu）
（设为
会让 APCu 每次检查文件时间戳，直接跳过缓存）
验证方式：
，确保三者都输出
验证是否真生效，别信命令输出
命令没报错 ≠ 缓存已写入 ≠ 请求中命中。必须查运行时行为。
打开
，搜索
或
—— 没这串字，说明根本没启用
在 Web 请求中执行：
，返回非空数组才算成功
检查缓存命中率：
，反复刷新页面，数值应增长
部署后类找不到？大概率是旧缓存未清：
应加入上线脚本
最易被忽略的一点：APCu 缓存键基于项目路径和
的 autoload 配置哈希，换目录、改 PSR-4 前缀、甚至只是移动了整个项目，旧缓存就彻底失效且不会报错——你以为“没生效”，其实是“缓存不可用”。
apcucomposer installvendor/autoload.phpapcu_fetchcomposer installcomposer updatecomposer dump-autoloadUnrecognized option: --apcu-autoloadercomposer install --apcu-autoloader --no-devvendor/autoload.phpvendor/--no-scriptscomposer update--apcu-autoloader--apcu-autoloaderautoload_classmap.phpcomposer.json"config": { "optimize-autoloader": true }composer install --apcu-autoloader --optimize-autoloader --no-dev--optimize-autoloaderapcu_fetch('composer:autoload')falseapc.enabled=11Onapc.enable_cli=1composer installapc.stat=01php -i | grep -E "(apc.enabled|apc.enable_cli|apc.stat)"= 1vendor/autoload.phpapcu_fetchcomposer:autoloadphp -r "var_dump(apcu_fetch('composer:autoload'));"php -r "print_r(apcu_cache_info('user')['num_hits']);"php -r "apcu_clear_cache('user');"composer.json