Composer autoload 配置错误导致类找不到：PSR-4 命名空间前缀必须以 结尾（JSON 中写为 "App\"），classmap 路径须含 .php 且存在，修改后须运行 composer dump-autoload，加载优先级为 psr-4 → psr-0 → classmap → files。
autoload 配置里用错 psr-4 的命名空间前缀格式
Composer 不会自动补全末尾反斜杠，psr-4 的命名空间前缀必须以 结尾，否则类文件无法被定位。比如写成 "App": "src/"，实际应为 "App\": "src/"（注意双反斜杠是 JSON 字符串转义后的表现，真实含义是 App）。
常见错误现象：类 AppControllerHome 存在，但 new AppControllerHome() 报 Class 'AppControllerHome' not found。
- 检查
composer.json中autoload.ps r-4键值对的 key 是否含结尾反斜杠（JSON 里写成"App\"） - 运行
composer dump-autoload -o后，打开vendor/composer/autoload_psr4.php确认生成的映射是否包含'App\' => array(...) - 若命名空间不含子命名空间（如只有
App），也必须写成"App\"，不能省略
classmap 扫描时忽略 .php 文件扩展名或路径拼写错误
classmap 是静态扫描机制，不依赖文件名与类名匹配规则，但它严格依赖路径存在性与文件可读性。一旦路径写错、目录不存在、或文件没加 .php 后缀，composer dump-autoload 就不会把它们加入映射表。
常见错误现象：调用 MyHelper::doSomething() 时抛出 Class not found，但文件明明在 lib/MyHelper.php。
- 确保
autoload.classmap中列出的是相对路径（相对于composer.json所在目录），且路径实际存在："lib/MyHelper.php"✅，"lib/MyHelper"❌ - Windows 下路径分隔符写成
可能导致扫描失败，统一用/ - 运行
composer dump-autoload -a（强制重扫）后，检查vendor/composer/autoload_classmap.php是否包含对应类名和路径
开发中修改了 autoload 却没重新生成加载器
Composer 的自动加载逻辑完全基于 vendor/composer/ 下的 PHP 映射文件，这些文件只在执行 composer dump-autoload 或安装/更新依赖时生成。改完 composer.json 不执行该命令，改动就等于没发生。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见错误现象：反复确认配置无误，但新类仍无法加载；或旧类路径删了却还能 new 成功（缓存残留）。
- 每次修改
autoload段后，必须手动运行composer dump-autoload - 加
-o参数启用优化模式（生成扁平化映射），适合生产环境；开发中可省略，便于调试 - 如果之前用过
composer install --no-autoloader或删过vendor/composer/autoload_*.php，仅composer install不会重建它们，仍需显式触发dump-autoload
多个 autoload 类型共存时的优先级与覆盖行为
Composer 会按 psr-4 → psr-0 → classmap → files 的顺序尝试加载，但同一命名空间下，psr-4 和 classmap 若同时命中，psr-4 优先——这意味着你可能以为 classmap 覆盖了某个类，其实它根本没机会被查到。
常见错误现象：替换了一个第三方包里的工具类，用 classmap 指向本地副本，结果还是加载了原包里的版本。
- 运行
composer show -s查看当前生效的 autoload 规则顺序 - 避免对同一命名空间混用
psr-4和classmap；如需覆盖，优先用psr-4显式重映射整个命名空间 -
files类型是直接 require 的，没有命名空间概念，适合全局函数，但无法用于类覆盖
最常被忽略的一点：autoload 规则只影响 composer dump-autoload 生成的映射，不改变 PHP 自身的 include_path 或运行时 require 行为。任何绕过 Composer 加载器的手动 require，都不会受这些配置约束。
