Composer会隐式触发autoload规则：未配置时默认扫描src/（PSR-4）和lib/（PSR-0）；多个PSR-4规则按声明顺序匹配，首个路径存在即停止；vendor包规则会被合并，可能污染命名空间；需用dump-autoload --no-optimize和-v选项排查真实映射。
autoload规则在composer.json里怎么被隐式触发
Composer 会自动读取 composer.json 中的 autoload 和 autoload-dev 字段，但很多冲突其实来自你没写、但它“猜”出来的规则——比如你没配 psr-4，却在 vendor/ 外写了 src/ 目录，又恰好用了标准命名空间前缀；或者你删了 autoload 段，但 composer install 仍生成了 vendor/autoload.php，因为 Composer 默认 fallback 到扫描 src/（PSR-4）和 lib/（PSR-0）目录。
这类隐式行为不报错，但会导致类加载顺序错乱、同名类被错误覆盖、或 class_exists() 返回意外结果。
- 检查是否启用了
optimize-autoloader：它会把所有类路径预生成进vendor/composer/autoload_classmap.php，掩盖了 PSR 规则实际匹配逻辑 - 运行
composer dump-autoload --no-optimize后再测试，能暴露真实 autoload 路径解析过程 - 用
composer show -s查看当前生效的 autoload 映射（含 vendor 包的规则），注意输出里有没有重复的 namespace → path 条目
如何定位两个 PSR-4 规则谁先命中
当多个 psr-4 规则都匹配同一个类名（比如 "App\": "src/" 和 "App\": "legacy/src/"），Composer 按 composer.json 中声明顺序从上到下遍历，**第一个完全匹配的路径胜出**。但“完全匹配”不是字符串前缀匹配，而是按命名空间层级逐级比对路径是否存在对应子目录。
例如 AppFooBar 会尝试找：src/Foo/Bar.php → legacy/src/Foo/Bar.php，只要前者存在就停止查找，后者哪怕路径更“精确”也不会被用到。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
composer dump-autoload -v查看详细映射生成过程，它会打印每条规则扫描了哪些路径 - 临时注释掉部分
psr-4条目，观察vendor/composer/autoload_psr4.php文件内容变化 - 别依赖文件系统大小写：Linux 下
Src/和src/是不同目录，但 Windows/macOS 可能误判为同一路径，导致规则看似生效实则失效
vendor 包的 autoload 怎么干扰主项目
第三方包的 composer.json 里写的 autoload 规则，会被 Composer 合并进主项目的 autoloader。最常见问题是：某个包声明了 "": "src/"（空命名空间 + src 目录），结果把你项目根目录下的 src/ 也纳入它的规则范围，造成命名空间污染。
尤其要注意那些未严格限定命名空间的 legacy 包（如某些 WordPress 插件或私有 SDK），它们可能用 files 或 classmap 加载全局函数，而这些函数名恰好和你的代码冲突。
- 执行
composer show --tree找出可疑包，再进其vendor/{vendor}/{package}/composer.json查 autoload 定义 - 用
composer dump-autoload --no-dev排除autoload-dev干扰，确认问题是否仍存在 - 若确认是某 vendor 包导致，可用
autoload.exclude-from-classmap（Composer 2.2+）或在主项目autoload中加"exclude-from-classmap"数组，屏蔽它的特定路径
调试时该看哪个 autoload 文件
Composer 生成的 autoload 文件不止一个，不同场景加载不同文件：vendor/autoload.php 是入口，但它只 include 其他几个核心文件。真正决定类路径的是 vendor/composer/autoload_psr4.php（PSR-4）、autoload_classmap.php（classmap）和 autoload_files.php（files）。你改了 composer.json 却没生效，大概率是没重新生成对应文件，或 PHP 进程缓存了旧的 opcache。
- 修改后必须运行
composer dump-autoload，不能只靠composer install - 如果用了 Docker 或 CLI 环境，确认
opcache.enable_cli=1是否开启——它会让vendor/composer/*.php文件被缓存，改了也不重载 - 临时在
vendor/autoload.php开头加var_dump(__FILE__, get_included_files()); die;，能快速确认当前加载链路是否符合预期
隐式 autoload 冲突最难缠的地方在于：它不抛异常，只悄悄加载错的类。所以排查时别只盯报错，要盯「为什么这个类被从那里加载进来」——打开 autoload_psr4.php，对着类名手动推一遍路径匹配过程，往往比看文档更快。
