composer autoload 冲突主因是手动加载与自动加载共存、psr-4 路径不匹配、classmap 与 psr-4 混用不当、vendor 目录复用；应删尽手动 require 和 __autoload，统一路径映射，独立安装 vendor 并运行 dump-autoload -o。
老旧项目改用 Composer 时 autoload 冲突，90% 是因为手动加载逻辑和 Composer 自动加载规则同时存在、互相覆盖。直接删掉所有 require 和 __autoload，只留 vendor/autoload.php 这一条入口，是最快见效的起点。
PSR-4 命名空间与文件路径不匹配
老项目常把类放在 lib/ 或 includes/ 下，但没按命名空间组织文件结构。比如你写了 namespace PaymentAlipay;，却把文件放到了 lib/alipay.php，Composer 的 PSR-4 规则压根不会去这个路径找。
- 必须保证：命名空间前缀（如
"Payment\": "src/Payment/"）和实际文件路径严格对应，src/Payment/Alipay.php→PaymentAlipay - 反斜杠要双写：
"Payment\": "src/Payment/"，单个在 JSON 里会被转义成非法字符 - 路径值必须是相对于
composer.json所在目录的相对路径，且末尾带斜杠（"src/"≠"src"） - 改完
composer.json后，必须运行composer dump-autoload -o，否则新规则不生效
classmap 和 PSR-4 混用导致类“两头不靠”
为兼容旧文件，有人在 autoload 里既配了 PSR-4，又加了 classmap 到同一目录，结果类名没声明 namespace，PSR-4 跳过，而 classmap 又没显式包含该文件——类就彻底消失了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
classmap只认物理路径，不看 namespace；PSR-4 只认 namespace + 目录结构，不看文件名 - 混用可以，但同一类不能被两种规则同时覆盖；建议老代码统一走
classmap，新代码走 PSR-4 - 如果用了
classmap，确保路径下每个 PHP 文件都含class声明，纯函数文件会触发警告甚至中断生成 - 验证是否生效：查看
vendor/composer/autoload_classmap.php，搜索你的类名，看是否已映射到正确路径
手动 require 与 vendor/autoload.php 共存
最隐蔽也最常见：老项目入口文件里还留着 require 'lib/Database.php'; 或自定义 __autoload()，而 Composer 的自动加载器又注册了一次同名类——PHP 报 Cannot declare class XXX。
- 找到所有
require、include、require_once加载类文件的地方，全部删掉或注释掉 - 检查是否有全局
__autoload或spl_autoload_register回调，它们会和 Composer 的 autoloader 冲突 - 确认
vendor/autoload.php是项目中**第一个**被require的自动加载文件，且只被引入一次 - ThinkPHP、CodeIgniter 等框架有自己配置项（如
$config['composer_autoload']），别在框架外再手动require
vendor 目录被多个项目复用
尤其在本地开发环境，为省空间把几个老项目的 vendor 链接到同一目录，会导致 autoload.php 里的 __DIR__ 指向错误位置，PSR-4 映射全乱。
- 检查系统环境变量，删掉
COMPOSER_VENDOR_DIR（它会让所有项目写进同一个 vendor） - 每个项目必须独立执行
composer install，不能复制或软链接 vendor - 验证方式：在项目根目录运行
php -r "echo __DIR__;"，对比vendor/autoload.php开头的__DIR__输出是否一致 - 若已混乱，删掉当前项目的
vendor/和composer.lock，重新composer install --no-dev --optimize-autoloader
真正卡住的点往往不在 autoload 配置本身，而在那些没被注释掉的 require、没被清理的全局 autoloader、或者被共享的 vendor 目录——它们像幽灵一样干扰 Composer 的路径解析，而且错误提示极少直接指向这些位置。
