class not found 或 cannot redeclare class 错误主因是 autoload_classmap.php 中同一类名映射多个路径，常见于 composer.json 中 psr-4 与 classmap 路径重叠或 autoload/ autoload-dev 配置冲突。
composer dump-autoload 时提示 Class not found 或 Cannot redeclare class
这类错误往往不是类文件缺失，而是自动加载映射冲突——Composer 在生成 vendor/composer/autoload_classmap.php 时，把同一个类名映射到了多个物理路径。最常见原因是：手动修改过 composer.json 的 autoload 或 autoload-dev 配置，或同时启用了 psr-4 和 classmap 且路径有重叠。
用 composer show --platform 查看已注册的 autoloader 类型
这个命令不会直接列出重复类，但它能帮你确认当前项目是否混用了多种 autoload 方式（比如同时存在 psr-4 和 classmap），这是重复映射的高发场景：
-
composer show --platform会输出所有已加载的 Composer 自动加载器类型 - 如果看到
classmap和psr-4同时启用，且它们的路径有交集（例如都包含src/），就极可能产生冲突 - 注意检查
composer.json中autoload和autoload-dev两节是否各自定义了相同命名空间或目录
生成并人工检查 autoload_classmap.php
运行 composer dump-autoload -o（带优化开关）后，打开 vendor/composer/autoload_classmap.php，直接搜索类名即可定位重复项：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 该文件是 PHP 数组，键为完整类名（如
"App\Helper\Utils"），值为绝对路径 - 用编辑器全局搜索引号包裹的类名，看是否出现多次（同一类名对应多个路径即为冲突）
- 特别注意大小写：Windows 下文件系统不区分大小写，但 Composer 映射严格区分，
Utils.php和utils.php可能被同时收录 - 若发现重复，回溯到
composer.json中对应路径配置，删掉冗余的classmap条目或调整psr-4前缀范围
用 composer dump-autoload --no-dev -v 观察详细输出
加 -v（verbose）参数可让 Composer 在生成映射时打印每个扫描到的类及其来源文件，便于快速发现异常：
-
composer dump-autoload --no-dev -v会逐行输出类似Adding AppHelperUtils => /path/to/src/Utils.php的日志 - 如果某类名连续出现两次，说明它被两个不同规则捕获（比如既匹配
psr-4规则，又被classmap手动添加过） - 此时不要依赖
composer validate—— 它只校验 JSON 结构，不检查映射逻辑
真正麻烦的不是发现重复，而是某些类在开发环境能跑通（因为 autoloader 缓存或文件系统特性掩盖了问题），上线后才暴雷。所以每次修改 autoload 配置后，务必清空 vendor/composer/autoload_*.php 并重新 dump，再 grep 确认类名唯一性。
