composer dump-autoload -v 是唯一可信入口，它逐行打印自动加载推导过程，包括目录扫描、PSR-4前缀识别及跳过原因，不依赖缓存，可定位命名空间未解析、路径错误、BOM、parse error等根本问题。
autoload 冲突不是类没写对，而是 Composer 根本没扫描到你的文件——必须看 composer dump-autoload -v 的实时输出，否则全靠猜。
为什么 composer dump-autoload -v 是唯一可信入口
这个命令会逐行打印自动加载器的推导过程，包括目录扫描顺序、PSR-4 前缀识别结果、文件跳过原因。它不依赖缓存，不走 vendor/autoload.php，是 Composer 加载逻辑的“原始日志”。
- 如果输出里完全没出现你的命名空间（比如
"App\"），说明composer.json的autoload配置压根没被解析——常见于 JSON 语法错误、末尾漏逗号、或 PSR-4 键值写成"App"（缺反斜杠） - 如果某目录被扫了但没列出任何类，可能是该目录下所有 PHP 文件都含 BOM、短标签未启用、或存在
.php.bak这类非法文件导致解析中断 - 输出中出现
Skipping file ... due to parse error，直接定位到那行报错的文件和行号，不用全局 grep
从 vendor/composer/autoload_psr4.php 反向验证映射
这是最终生效的映射表，不是缓存，是事实真相。打开它，搜索你的命名空间前缀（如 "App"），确认两点：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 映射的路径是否为你项目中真实的绝对路径（例如
/var/www/myapp/src/），而不是相对路径或拼写错误的路径 - 路径末尾是否有斜杠（
"src/"✅ vs"src"❌）——某些系统下行为不一致 - 如果你的类文件在
src/Http/Controllers/HomeController.php，但命名空间是namespace AppHttpControllers;，而 autoload 配置却是"App\": "app/"，那 Composer 会去app/Http/Controllers/HomeController.php找，自然失败
常见日志线索与对应问题
运行 composer dump-autoload -v 后，盯住这几类关键词：
-
Scanning directory src→ 确认是否扫到了你放类的目录；没出现？检查composer.json中路径是否写成./src/或绝对路径 -
Found class App\Controllers\HomeController in src/Controllers/HomeController.php→ 映射成功，问题不在 autoload，转查vendor/autoload.php是否被正确引入 -
Skipping file src/Utils/Helper.php: no namespace found→ 文件里没写namespace，但你却用 PSR-4 配置了该路径，要么补 namespace，要么改用classmap -
PSR-4 mapping for "MyLib\" does not exist→ 配置的命名空间前缀和 PHP 文件里的namespace声明不一致（大小写、反斜杠、多空格）
为什么不能只信 composer install 或 require 的报错
这些命令触发的是运行时加载失败，错误信息通常是 Class 'AppControllersHomeController' not found，它不告诉你“为什么找不到”，只告诉你“没找到”。而 autoload 冲突的本质是路径推导阶段就断了，不是类定义出错。真正要问的不是“类在哪”，而是“Composer 认为它该在哪”——这个答案只藏在 dump-autoload -v 和 autoload_psr4.php 里。
