composer dump-autoload 是重写自动加载映射文件的唯一手动入口，而非刷新缓存；若执行后仍 class_exists() 返回 false，主因是 composer.json 中 autoload 未声明路径、psr-4 前缀末尾缺双反斜杠、路径非项目根目录下相对路径或文件名大小写不匹配。
类找不到？不是 autoload 失效，而是映射根本没更新——composer dump-autoload 不是“刷新缓存”，它是重写映射文件的唯一手动入口。
为什么 dump-autoload 后 class 还是 not found
命令跑成功了，但 class_exists('AppServicesUserService') 返回 false，问题几乎总出在三处：
-
composer.json 的
autoload段压根没声明你放类的路径，比如类在src/，却只配了"App": "app/" - PSR-4 前缀末尾漏了反斜杠：
"App"无效，必须是"App\"（注意双反斜杠是 JSON 字符串转义） - 路径写成绝对或带点前缀：
"./src/"、/var/www/src/都不认，只能是项目根目录下的相对路径，如"src/" - Linux 下文件名大小写不匹配：类名
UserRepository，文件却是userrepository.php，本地 Windows 可能蒙混过关，CI 就直接崩
什么时候必须加 -o 参数
不加 -o，composer dump-autoload 只更新 PSR-4 路径映射，**不会扫描磁盘上新增的 .php 文件**。也就是说：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你刚在
src/下新建了Helper.php，对应命名空间App\Helper，但没加-o→new AppHelper()必报错 - 用了
"classmap": ["src/"]配置？默认dump-autoload根本不触发扫描，必须加-o才会重新遍历并生成autoload_classmap.php - Laravel 的测试类、扩展包里的非 PSR-4 类（比如
files数组里引入的全局函数），多数依赖-o生成的 classmap 才能加载
开发中该用 --no-optimize 还是 -o
开发阶段建议先试 composer dump-autoload --no-optimize：
- 它只更新 PSR-4 映射，不生成 classmap，新增类文件后无需再跑命令就能被加载（适合快速迭代）
-
-o生成的autoload_classmap.php是静态数组，改一个类就得重跑dump-autoload -o，否则立刻失效 - 如果你开了
--classmap-authoritative（即-a），连 PSR-4 fallback 都关了——没进 classmap 的类，PHP 直接放弃查找，连提示都不给
怎么确认 autoload 真生效了
别信终端输出的 “Generating autoload files…”，也别靠 IDE 补全判断。直接查生成文件：
- 打开
vendor/composer/autoload_psr4.php，搜你的命名空间前缀（如'App\'），看值是不是你预期的路径（如$baseDir . '/app'） - 如果用了
-o，再打开vendor/composer/autoload_classmap.php，搜完整类名（如App\Services\UserService），确认有对应路径 - 加一行临时调试代码：
var_dump(class_exists('Your\Full\ClassName'));，结果为true才算真通
最常被忽略的一点：Composer 生成的映射是大小写敏感的，而 macOS / Windows 文件系统默认不敏感——你在本地跑通了，不代表部署到 Linux 就行；路径配置里写 "App" 这种半截子字符串，JSON 解析不报错，但 Composer 直接跳过整条规则。
