根本原因是 composer 未更新自动加载映射表，需手动执行 composer dump-autoload -o；composer install 不重建 autoload，新增包须用 require，改 autoload 配置后必须手动 dump，且 -o 才生成 classmap 并确保 psr-4 路径、命名空间、文件名三者严格匹配。
安装了包但类找不到，根本不是包没下下来，而是 Composer 没把它的命名空间写进自动加载映射表——composer dump-autoload -o 没跑，或者跑错了时机。
为什么 composer install 后类还是报错
因为 composer install 只还原 vendor/ 和 composer.lock，它不改 composer.json，也不触发自动加载重建。你手动加了个包、切了 Git 分支、或改了 autoload 配置，它都无动于衷。
- 新增包必须用
composer require vendor/package，它才会同步写composer.json+ 下包 + 自动 dump - 改过
composer.json的autoload段（比如加了"App": "src/"），必须手动补composer dump-autoload -o -
--no-autoloader或--no-scripts会跳过 autoload 生成，部署脚本里常见这种坑 - Linux/macOS 上删过
vendor/再install，旧的autoload_classmap.php可能残留路径，导致 PHP 去找一个已不存在的文件
composer dump-autoload -o 为什么非加 -o 不行
不加 -o 是“开发模式”生成：只更新 PSR-4 映射，不扫描文件内容，也不建 classmap。而很多包（尤其 Laravel 扩展、测试工具）依赖 classmap 或 files 加载方式，不加 -o 就等于没生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
-o强制扫描所有类文件并生成autoload_classmap.php，这是生产环境默认行为 - 如果你新增了类但没出现在
autoload_classmap.php里，说明-o没跑，或该类不在任何已声明的 autoload 路径下 - 运行
composer dump-autoload -v可看到它实际扫描了哪些路径和类名，目标类没出现在输出里？那配置或路径肯定有硬伤
怎么确认 autoload 映射真生效了
别信 IDE 补全，也别靠 ls vendor/ 看文件在不在——直接查生成的映射文件和运行时结果。
- 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如'App\'），看对应路径是不是你预期的（如$baseDir . '/src'） - 打开
vendor/composer/autoload_classmap.php，搜类名（如AppServicesUserService），看是否指向正确文件路径 - 在代码里加一行：
var_dump(class_exists('AppServicesUserService'));，返回false就是 autoload 没覆盖到，不是代码问题 - 检查入口文件是否真引入了
vendor/autoload.php：必须是require __DIR__ . '/vendor/autoload.php';，且前面不能有任何输出（包括 BOM、空格、echo）
文件路径、命名空间、类名三者怎么才算“严丝合缝”
PSR-4 不是字符串拼接，是路径推导。配置 "App\": "src/" 时，AppHttpControllersHomeController 必须落在 src/Http/Controllers/HomeController.php，差一个字母、大小写、斜杠、目录层级都会断。
- 命名空间末尾必须带双反斜杠：
"App\": "src/"✅，"App": "src/"❌（JSON 解析失败，映射静默失效） - 路径末尾必须带斜杠：
"src/"✅，"src"❌（会被当成平铺结构，不进子目录） - Linux/macOS 文件系统区分大小写：文件叫
homecontroller.php或HomeController.php，但类名是HomeController→ 必须严格匹配，否则class_exists()返回false - Git 提交时注意：Windows 下可能自动转小写，推到 Linux 服务器就挂；用
git config core.ignorecase false强制校验
最常被忽略的是：改完 composer.json 后只 install 不 dump-autoload -o，或者以为 require 会自动处理所有情况，结果新类压根没进映射表。autoload 不是实时监听，它是快照——拍一次，用一次。
