类映射失效需手动执行 composer dump-autoload 更新 autoload_ps4.php 或加 -o 生成 autoload_classmap.php，因 composer 不自动扫描文件变更；配置错误、路径/命名空间不规范、files 误用等也会导致 class not found。
类映射失效不是 Composer “坏了”，而是它压根没被告知代码结构变了——vendor/autoload.php 里用的映射文件（比如 autoload_psr4.php 或 autoload_classmap.php）不会自动更新，必须手动触发重建。
为什么改了类或 composer.json 后 new 一个类就报 Class not found
Composer 的自动加载靠的是静态映射表，不是实时扫描。你新增了一个 src/Services/CacheManager.php，哪怕命名空间、路径、文件名全对，只要没跑过 composer dump-autoload，映射表里就没有这条记录，PHP 就找不到类。
- 只改类内部逻辑（比如改个 return 值），不用跑命令
- 新增/移动/删除类文件，或修改
composer.json中的autoload/autoload-dev字段，就必须执行 - Git 拉完代码后发现新类报错，大概率是队友提交了新类但没同步更新 autoload 文件
-
composer install和composer update会顺带刷新 autoload，但不该为这目的去用——它们会重装依赖，可能覆盖本地改动或升级不兼容版本
dump-autoload 不加 -o 为什么经常没用
默认的 composer dump-autoload 只重写 PSR-4 静态映射（如 autoload_psr4.php），不扫描磁盘上实际存在的 PHP 文件。如果你新增了类、改了文件名、或者移动了目录，这些变更不会进 classmap，也就无法被快速定位。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加
-o（即--optimize）才会清空并全量扫描所有 autoload 配置路径下的.php文件，生成新的autoload_classmap.php - 不加
-o时，PSR-4 映射虽更新，但运行时仍要靠“拼路径 + file_exists()”动态查找，慢且容易因大小写、路径分隔符出错 - Linux/macOS 上路径大小写敏感，Windows 下不敏感——但 classmap 是大小写精确匹配，所以 Windows 开发者在 CI 上常踩这个坑
为什么跑了 dump-autoload -o 还是 Class not found
命令执行成功 ≠ 映射生效。真正卡点往往在配置源头，而不是命令本身。
-
composer.json里 PSR-4 命名空间末尾缺反斜杠：写成"App": "app/"是错的，必须是"App\": "app/"（JSON 中双反斜杠表示单个反斜杠） - 路径写成
"../lib"或绝对路径，Composer 会静默忽略，不报错也不映射 - 类文件放在
app/Console/Commands/DeployCommand.php，但命名空间是namespace AppConsoleCommands;（漏了分隔符），PSR-4 规则无法匹配 - 用了
"files": ["helpers.php"]加载函数，但误以为里面定义的 class 也会被自动加载——files只 require，不注册类 - 检查
vendor/composer/autoload_psr4.php，搜你的命名空间前缀，确认数组键存在且值是预期路径
生产环境别单独跑 dump-autoload -o
Composer 2.x 默认在 install 或 update 时生成 classmap，但 dump-autoload -o 单独执行时，多数情况下不会重建 autoload_classmap.php —— 它只在有明确 classmap 配置或启用 --classmap-authoritative 时才真扫描。
CI/CD 中应固定用：composer install --no-dev --optimize-autoloader。这个命令才确保 classmap 被完整生成且与当前代码一致。单独跑 dump-autoload -o 很可能白干，连 autoload_classmap.php 文件都不会出现。
