执行 composer dump-autoload -o 是解决“class not found”的直接有效操作，但前提是 composer.json 中 autoload 段已正确定义路径与命名空间映射；该命令仅按配置扫描，不自动发现类，若配置缺失、错误或路径未声明，则映射表中无对应类，必然报错。
执行 composer dump-autoload -o 是解决 “Class not found” 最直接有效的操作，但前提是你的 composer.json 里已正确定义了类所在路径与命名空间的映射关系——命令本身不会自动发现或猜测路径。
为什么 composer dump-autoload 不生效
不是命令没跑，而是它只按 composer.json 的 autoload 段干活。如果配置漏了、写错了、或路径根本不在声明范围内，dump 出来的映射表里自然没有你的类。
-
"psr-4": { "App": "app/" }要求类文件必须在app/Http/Controllers/HomeController.php，对应命名空间AppHttpControllersHomeController；若把文件放在src/下却没配"App": "src/"，dump 就不会扫它 - 末尾反斜杠不能少：
"App"正确，"App"或"App\"都会导致整个 PSR-4 规则被忽略（JSON 解析可能不报错，但 Composer 不认） - 路径必须是项目根目录下的相对路径，
"./app/"、"/var/www/app/"这类写法无效 - 文件名大小写必须和类名完全一致：Linux 下
usercontroller.php无法加载UserController类，即使 Windows 能跑，部署就崩
composer dump-autoload -o 和 -a 的区别
-o（--optimize）强制启用 classmap 优化，会扫描所有已声明的 PSR-4/classmap 路径并生成 vendor/composer/autoload_classmap.php；-a（--classmap-authoritative）更进一步，告诉 Composer “所有类都必须在 classmap 里，别再 fallback 到 PSR-4 动态查找”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 加
-o是生产环境默认行为，也是本地排查的推荐起点；不加-o只更新 PSR-4 映射，不生成 classmap，很多包（如 Laravel 扩展、测试工具）依赖 classmap 加载，此时类仍找不到 - 加
-a后，Composer 完全跳过 PSR-4 的目录遍历逻辑，只查 classmap 表——这意味着你新增一个类，不重新dump-autoload -o -a，它永远进不了自动加载流程 - 开发中慎用
-a：改一个文件就得重跑命令，否则立刻报错；CI/CD 构建镜像时可用，但需确保所有类已稳定
怎么确认 autoload 真生效了
别信 IDE 补全、别靠 ls vendor/ 看文件在不在——直接查生成的映射文件和运行时结果。
- 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如'App'），看对应路径是否是你预期的（如$baseDir . '/app'） - 打开
vendor/composer/autoload_classmap.php，搜完整类名（如AppServicesUserService），看是否指向正确文件路径 - 在代码里加一行：
var_dump(class_exists('AppServicesUserService'));，返回false就说明 autoload 没覆盖到，不是代码问题 - 运行
composer dump-autoload -v，观察输出里有没有类似Adding PSR-4 autoload rule for App: app/，以及目标类文件是否出现在扫描列表中
autoload-dev 里的类总报错
autoload-dev 默认只在 composer install（含 dev 依赖）或显式加 --dev 时才参与生成。CI 部署常用 composer install --no-dev，此时 autoload-dev 完全被跳过。
- 测试类（如
TestsUnitUserTest）写在autoload-dev.psr-4里，生产环境运行就会Class not found - 若需在生产也加载这些类（比如某些 CLI 工具），应移到主
autoload.psr-4，或部署脚本中显式加composer dump-autoload -o --dev - 检查是否真安装了 dev 依赖：
composer show | grep phpunit，无输出说明--no-dev生效了
最常被忽略的一点：vendor/autoload.php 必须被 require_once 且是入口文件第一行（前面不能有任何输出，包括 BOM、空格、echo），否则整个 autoload 机制从源头就失效。另外，OPcache 缓存旧映射时，dump-autoload 生成了新文件也没用，得清缓存或重启 PHP-FPM。
