class_exists()返回false时，首要排查动作是执行composer dump-autoload重写映射文件；若仍失败，需检查composer.json autoload配置路径、psr-4前缀反斜杠、相对路径格式、大小写一致性，并确认新增类是否需加-o参数触发扫描。
class_exists() 返回 false 时，dump-autoload 是第一排查动作
它不是“刷新缓存”，而是重写 vendor/composer/autoload_psr4.php、autoload_classmap.php 这些映射文件。命令执行成功 ≠ 类能加载，关键看配置是否真实生效。
常见现象：composer dump-autoload 跑完，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 就找不到新类
composer dump-autoload 默认只更新 PSR-4 映射逻辑，**不会扫描磁盘上新增的 .php 文件**。也就是说，你刚在 src/ 下新建了 Helper.php，对应命名空间 AppHelper，但没加 -o → new AppHelper() 必报错。
以下情况必须加 -o 才能生效：
- 用了
"classmap": ["src/"]配置？默认dump-autoload根本不触发扫描，必须加-o才会遍历并生成autoload_classmap.php - Laravel 的测试类、扩展包里的非 PSR-4 类（比如
files数组里引入的全局函数），多数依赖-o生成的 classmap 才能加载 - 你改了类文件名或挪了位置，但没同步改命名空间 ——
-o会把当前磁盘文件结构硬编码进映射表，错配立刻暴露
开发阶段该用 --no-optimize 还是 -o
开发中建议先试 composer dump-autoload --no-optimize：它只更新 PSR-4 映射，不生成 autoload_classmap.php，新增类文件后无需再跑命令就能被加载（适合快速迭代）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-o 生成的是静态数组，改一个类就得重跑 dump-autoload -o，否则立刻失效。更麻烦的是，如果你开了 --classmap-authoritative（即 -a），连 PSR-4 fallback 都关了——没进 classmap 的类，PHP 直接放弃查找，连提示都不给。
一句话：-o 是构建阶段的一次性快照，不是开发开关；--no-optimize 才是开发机上的友好模式。
怎么确认 autoload 真生效了
别信终端输出的 “Generating autoload files…”，也别靠 IDE 补全判断。直接查生成文件：
- 打开
vendor/composer/autoload_psr4.php，搜你的命名空间前缀（如'App\'），看值是不是你预期的路径（如$baseDir . '/src/'） - 如果用了
-o，再打开vendor/composer/autoload_classmap.php，搜完整类名（如AppServicesUserService），确认有对应路径 - 注意：
autoload_classmap.php不是每次请求都生成，它只是个静态数组文件，内容形如：return [ 'AppServicesUserService' => $vendorDir . '/myproject/src/Services/UserService.php', ];
最常被忽略的点是：本地开发长期开着 --optimize-autoloader，结果改了类名或挪了文件却忘了再 dump-autoload -o，报错时第一反应查命名空间拼写——其实只要删掉 vendor/composer/autoload_classmap.php 再跑一次 composer dump-autoload 就行。
