psr-4映射必须严格匹配命名空间末尾反斜杠，如"app": "app/"（json中写为"app\": "app/"），路径、namespace声明与composer.json三者需完全一致，否则类无法加载。
psr-4 映射必须严格匹配命名空间末尾反斜杠
“App”和“App”在 PSR-4 配置里是完全不同的前缀——少一个反斜杠，Composer 就会把 AppHttpController 当作独立命名空间去匹配，而不是 AppHttpController 的子路径。结果就是类文件明明在 app/Http/Controller/HomeController.php，却始终报 Class not found。
正确写法只能是："App\": "app/"（JSON 中双反斜杠表示一个字面量反斜杠）。IDE 自动生成命名空间时容易漏掉这个反斜杠，尤其从文件路径转换过来时；Windows 下大小写不敏感还会掩盖问题，上线前务必在 Linux 环境执行 php -r "var_dump(class_exists('App\Http\Controller\HomeController'));" 验证。
多层级命名空间不能靠“模糊映射”，必须路径与声明一致
PSR-4 不支持通配符或层级跳过。比如你写了 "App\": "src/"，那 App\Database\Connection 就必须对应 src/Database/Connection.php；如果实际文件在 src/Models/Database/Connection.php，自动加载器不会“猜”你是不是想把 Models 当作中间层——它只会拼出 src/Database/Connection.php 并失败。
- 改了目录结构（如从
src/Controllers/搬到src/Http/Controllers/），必须同步改composer.json里的映射值和所有类文件中的namespace - src/ 下不能混放不同命名空间的类：比如
src/Database/Seeder.php声明namespace IlluminateDatabase;，而src/Database/Connection.php声明namespace AppDatabase;，前者就永远进不了App\映射 - 检查映射是否生效：运行
php -r "var_dump(require 'vendor/composer/autoload_psr4.php');"，确认App\对应的路径确实是app/或src/，且末尾没多出空格或正斜杠
classmap 是补救手段，但不是替代方案
当项目存在跨层级、无规律命名空间（比如 legacy 类、第三方脚本、动态生成类）时，classmap 可以兜底扫描整个目录。但它和 PSR-4 是并行关系，不是 fallback：自动加载器先查 classmap，没命中才走 PSR-4 路径。所以如果你只加了 "classmap": ["app/"] 却没删掉错误的 PSR-4 配置，反而会让问题更难排查。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
要让 classmap 真正覆盖多层级混乱的类，得明确两点：
-
composer.json中必须显式声明"classmap": ["app/"]，不能指望dump-autoload -o自动扫——它只优化已有 PSR-4 映射，不新增扫描路径 - 执行
composer dump-autoload -a（不是-o），强制递归读取每个.php文件并提取class/interface/trait声明 - 别把
tests/或examples/加进 classmap，它们会被无差别扫入，膨胀映射表且无业务意义
--classmap-authoritative 会彻底关闭 PSR-4 回退，慎用
加了 -a 参数后，自动加载器一旦在 classmap 里找不到类，就直接抛错，不再尝试按 PSR-4 规则拼路径去文件系统找。这对部署环境很安全（防止意外加载未声明的类），但对开发阶段极其危险——比如你刚新建了一个 App\Http\Middleware\LogRequest，还没跑 dump-autoload -a，它就永远加载不到。
典型踩坑场景：
- Docker 构建时用了
composer install --classmap-authoritative，但 CI 流水线没触发dump-autoload -a，导致新类缺失 - 本地开发开了
"optimize-autoloader": true和"classmap-authoritative": true，改完类名忘了手动重生成 autoload 文件 - 运行时动态生成类（如 Doctrine Proxy、Laravel View Components 编译产物），
-a模式下它们根本不会被识别
多层级命名空间本身不复杂，真正卡住人的永远是三处没对齐：文件路径、namespace 声明、composer.json 里的映射字符串——差一个反斜杠、一个字母大小写、一个目录层级，就全盘失效。
