class_exists() 返回 false 说明 autoload 未生效，需先检查 vendor/autoload.php 是否正确加载；psr-4 映射重复会导致后注册覆盖前注册，应通过 dump-autoload -v 和 autoload_psr4.php 查重；冲突时应改用 classmap 并手动维护路径唯一性。
class_exists() 返回 false 说明 autoload 没走通，不是命名空间冲突
看到 Fatal error: Cannot declare class Xxx 就去查命名空间撞车？大概率方向错了。先确认 autoload 是否生效：
在出错脚本最开头加 var_dump(class_exists('Monolog\Logger'));，输出 false 就说明 vendor/autoload.php 根本没被加载，或者路径错了。
常见漏点：
• CLI 脚本里忘了写 require __DIR__ . '/vendor/autoload.php';
• file_exists(__DIR__ . '/vendor/autoload.php') 返回 false，因为当前脚本位置和 $_SERVER['DOCUMENT_ROOT'] 不一致
• 缓存干扰：删掉 vendor/composer/autoload_*.php 后再跑 composer dump-autoload
dump-autoload -v 输出里出现两行 App\ => src/ 就是 PSR-4 映射重叠实锤
PSR-4 映射重复不会报错，但后注册的会覆盖前一个，导致类随机加载失败或第二次调用直接崩。
定位方法很直接：
• 执行 composer dump-autoload -v，搜索你的命名空间（如 App\），看是否重复出现映射行
• 打开 vendor/composer/autoload_psr4.php，搜类名关键词，确认它到底映射到了哪个物理路径；如果一个类出现在两个路径下，就是冲突确认
• 检查所有依赖包的 composer.json，重点盯 autoload 和 autoload-dev 字段，有没有泛用前缀（如 "" 或 "App\": "src/"）
• 注意：psr-4 命名空间必须以反斜杠结尾："App\": "src/" ✅，"App\": "src" ❌（后者会让类名解析多一层）
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
多个包都声明 App\ => src/？别硬塞映射，改用 classmap + 手动维护
Composer 不支持多个包声明相同命名空间前缀，psr-4 映射只会保留最后一个，前面的被静默覆盖。
唯一能绕过覆盖逻辑的落地方式是弃用 psr-4，改用 classmap：
• 在每个冲突包的 composer.json 中，删掉 psr-4 对该命名空间的声明，改用 "classmap": ["src/"]
• 主项目执行 composer dump-autoload -o，确保 classmap 生效
• 所有同名空间下的类，必须保证文件路径不重名（例如 PackageA/src/CacheService.php 和 PackageB/src/CacheService.php 不能同时存在）
• 注意：classmap 不支持自动发现新增类，每次加新类都要重新运行 composer dump-autoload
exclude-from-classmap 只对 classmap 生效，对 psr-4 完全无效
exclude-from-classmap 是 composer.json 里用于从 classmap 生成阶段排除路径的配置项，但它不支持通配符或文件名匹配，只接受相对于项目根目录的完整路径（必须带扩展名）。
常见错误写法：
• "ExcludeMe.php" —— 无效，Composer 静默忽略
• "legacy" —— 必须写成 "legacy/"（末尾斜杠表示目录）
• "Src/" ≠ "src/"（Linux/macOS 区分大小写）
它只影响 classmap 类型的自动加载，对 psr-4 冲突毫无作用 —— psr-4 冲突得靠移除文件、重命名或调整映射前缀来解决
psr-4 映射就能覆盖依赖包的配置，其实不行。Composer 的 autoload 映射是扁平合并的，主项目配置无法“压过”已安装包的 autoload 声明。真正要动的，永远是那个冲突包自己的 composer.json。
