定位类名冲突需先运行composer dump-autoload -o --verbose查看重复类及其路径，再检查autoload_classmap.php中同名类的多条映射，确认psr-4前缀是否重叠及顺序，并用composer show -p验证生效映射。
Composer autoload 发现类名重复，怎么定位冲突文件
Composer 在 dump-autoload 或运行时抛出 Class 'Xxx' not found 或更隐蔽的 Cannot declare class Xxx, because the name is already in use，本质是两个不同文件定义了同名类（哪怕只是 class_exists() 触发了其中一个），而 Composer 的 PSR-4/PSR-0 自动加载机制把它们都注册进了 autoload_classmap.php 或扫描路径中。
关键不是“哪个类写错了”，而是“哪两个文件在打架”。最直接的办法是让 Composer 把所有被扫描到的类路径打出来：
- 运行
composer dump-autoload -o --verbose，观察终端输出里重复出现的类名及其对应文件路径 - 若没显式报错，用
php -d display_errors=1 -d error_reporting=-1 vendor/autoload.php手动触发加载，配合error_log()或 xdebug 断点看__autoload或spl_autoload_call被调用了几次、每次加载了哪个文件 - 检查
vendor/composer/autoload_classmap.php，搜索目标类名 —— 如果出现多条映射，说明多个文件被静态扫描到了
为什么 exclude-from-classmap 不能只写文件名
exclude-from-classmap 是 composer.json 里用于从 classmap 生成阶段排除路径的配置项，但它**不支持通配符或文件名匹配**，只接受相对于项目根目录的**目录或具体文件路径（必须带扩展名）**。写 "ExcludeMe.php" 是无效的，Composer 会静默忽略。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确写法是完整路径，例如：
"src/Deprecated/Helper.php"或"legacy/"（注意末尾斜杠表示目录） - 路径区分大小写，Windows 下可能不敏感，但 Linux/macOS 会严格匹配，
"Src/"≠"src/" - 它只影响
classmap类型的自动加载（比如你用了"classmap": ["src/"]），对 PSR-4 完全无效 —— PSR-4 冲突得靠移除或重命名文件，或调整psr-4映射前缀
PSR-4 映射重叠导致类被双加载？优先级怎么算
当两个 psr-4 配置指向同一命名空间前缀（如都映射 "App\" 到不同目录），Composer 不会报错，但会按 composer.json 中声明的**顺序依次尝试加载**：先查第一个路径，找不到再查第二个。一旦某个路径下存在匹配文件，就立即返回，后面路径里的同名类永远不会被加载 —— 但问题在于，如果这两个路径里都有 AppFoo，而你又在别处用 require 或 include 手动加载了另一个，冲突就爆发了。
- 检查
composer.json的autoload.psr-4和autoload-dev.psr-4，确认没有重复前缀映射 - 用
composer show -p查看当前生效的 PSR-4 映射列表及顺序 - 开发中临时注释掉一个映射，再
composer dump-autoload，看问题是否消失，可快速定位干扰源
不想删文件又想彻底屏蔽某目录？用 autoloading 的“软隔离”
有些遗留代码不能删、也不能改类名，但又不能让它参与自动加载 —— 此时靠 exclude-from-classmap 不够（尤其对 PSR-4），得在加载逻辑层做拦截。
- 在
composer.json的autoload.files里加一个引导文件，例如"src/bootstrap-exclude.php" - 在这个文件里，用
spl_autoload_register注册一个高优先级加载器，对特定命名空间或路径前缀直接返回（不加载），例如：
if (strpos($class, 'Legacy\') === 0) {
return;
}
- 注意这个注册器要放在所有其他自动加载器之前（所以放
autoload.files最稳妥），否则可能被 Composer 默认加载器抢先加载 - 这种方法绕过了 Composer 的路径扫描，但要求你明确知道哪些类不该加载，适合灰度下线场景
真正麻烦的不是配置写法，而是当多个第三方包各自声明了相同命名空间、又都放进 autoload.psr-4 时，你连改 composer.json 的权限都没有 —— 这时候只能 fork 包、改它的 autoload 配置，或者用 replace + provide 强制 Composer 忽略其中一个。
