composer dump-autoload 为什么没生效
执行 composer dump-autoload 后类还是找不到，大概率不是命令错了，而是 autoloader 没被重新引入。Composer 生成的 vendor/autoload.php 是一个“快照”，它只在你 require 它的时候才生效；改完代码或 dump-autoload 后，如果 PHP 进程（比如 Web 服务器或 CLI 脚本）已经加载过旧的 autoload 文件，就不会自动刷新。
- CLI 场景下：每次运行脚本前确保没用 opcache 缓存旧的
autoload.php（可临时加opcache.enable=0验证） - Web 场景下：Apache/PHP-FPM 通常会缓存已加载的文件，重启服务或清空 opcache（
opcache_reset()）才能让新 autoload 生效 - 检查是否误删了
vendor/autoload.php——dump-autoload不会重建这个入口文件，它只更新内部映射表
什么时候该用 composer dump-autoload -o
composer dump-autoload -o（即 --optimize）会把 PSR-4/PSR-0 映射转成静态 classmap，提升类加载速度，但代价是失去自动发现新文件的能力——它只扫描当前已知的目录结构，不会监听后续新增的类文件。
- 适合上线环境或部署后不再增删类的场景；开发中频繁加新类时，用默认无参
dump-autoload更安全 - 如果项目用了
classmap配置（比如包含src/下非标准命名的文件），-o会强制把这些也扫进 classmap，否则默认只处理 PSR 规则路径 -
-o在 PHP 7.4+ + opcache 开启时效果明显；PHP 8.1+ 默认启用apcu或opcache的 class loading 优化，-o的收益变小，反而可能掩盖 autoloading 配置错误
autoload 配置改了但 dump-autoload 不识别
常见原因是 composer.json 里的 autoload 或 autoload-dev 格式有语法错误，或者路径写错导致 Composer 忽略整个区块。
- 确认缩进是空格（不是 tab），JSON 字段名拼写正确：
"psr-4"不是"psr4"，"files"数组里每个路径必须存在且可读 - 路径是相对于
composer.json所在目录的，比如"src/"表示同级的src/目录；写成"./src/"或"../src/"会导致扫描失败 - 运行
composer validate可快速暴露配置问题；若提示autoload field is not valid，就说明 autoload 区块解析失败，dump-autoload会静默跳过它
vendor/autoload.php 被修改后怎么恢复
别手动改 vendor/autoload.php —— 它是自动生成的，任何手改都会在下次 composer install 或 update 时被覆盖。真要调试 autoload 行为，应该看生成的 vendor/composer/autoload_*.php 文件（比如 autoload_static.php），它们才是实际被 vendor/autoload.php 引入的底层映射。
- 想重置 autoload 到干净状态：删掉
vendor/composer/autoload_*.php和vendor/autoload.php，再跑一次composer dump-autoload - 如果
composer install报错说找不到某个类，先检查是不是autoload配置漏写了对应命名空间，而不是怀疑 vendor 文件损坏 - 某些 IDE（如 PhpStorm）会缓存类索引，改完 autoload 后需手动触发 “Reload project from composer.json”
autoload 的关键不在命令多酷，而在路径、命名空间、文件存在性这三者严丝合缝。少一个 /，少一个 \，或者多一个空格，都可能让整个链路断在 require 那一行。
