psr-4命名空间键必须以双反斜杠结尾（如"app\": "src/"），否则被当作psr-0处理或忽略，导致class not found；修改composer.json后须执行composer dump-autoload生效，且需校验vendor/composer/autoload_psr4.php中是否生成对应映射。
PSR-4 命名空间必须带结尾反斜杠，否则类找不到
中文项目里常因转义或编辑器显示问题漏掉命名空间末尾的 \，比如写成 "App": "src/" 而不是 "App\": "src/"。JSON 里双反斜杠是合法写法，表示一个真实反斜杠；少一个就变成普通字符串前缀，PSR-4 查找时完全不匹配。
现象：类文件在 src/Controller/HomeController.php，定义了 namespace AppController;，但 new AppControllerHomeController() 报 Class 'AppControllerHomeController' not found。
- 检查
composer.json中autoload.psr-4的 key 是否为"App\": "src/" - 运行
composer dump-autoload -v，看终端是否输出Appending PSR-4 autoload rule for App\ - 打开
vendor/composer/autoload_psr4.php，确认是否存在'App\' => array(...)这一行
多个 PSR-4 路径共存时，顺序由数组书写位置决定
同一命名空间映射多个目录（如兼容新旧结构），必须用数组形式："App\": ["src/", "legacy/src/"]。不能写两个键，JSON 不允许重复 key。
加载行为是“第一个命中即止”：假设 src/Service/User.php 和 legacy/src/Service/User.php 都定义了 AppServiceUser，那么只有 src/ 下的会被加载，legacy/src/ 完全静默跳过。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 路径数组顺序 = 加载尝试顺序，和物理目录深浅、字母顺序无关
- 若想让
legacy/src/优先，就把它的路径提到数组前面 - 写成单字符串
"App\": "src/"在多路径场景下会失效，且 Composer 2.x 后版本可能警告
classmap 和 PSR-4 同名类冲突，classmap 总是赢
只要 classmap 扫描到了某个类文件，它就会直接加载，PSR-4 根本不触发。这跟“优先级”无关，而是 autoload 流程硬编码顺序：files → classmap → psr-4。
现象：你改了 src/AppHelper.php 的内容，但 new AppHelper() 始终加载旧逻辑——很可能 classmap 已登记了这个类，而你没重新生成映射表。
- 检查
composer.json是否启用了classmap（如"classmap": ["src/"]） - 运行
composer dump-autoload -a强制重扫，再查vendor/composer/autoload_classmap.php里有没有AppHelper的条目 - 如果不需要 classmap 行为，就删掉对应配置，或把文件移出扫描路径
files 不参与类加载，但它最先执行且不可跳过
files 是唯一无条件、按序 require_once 的机制，它不是“最后兜底”，而是“最先铺路”。一旦某个 files 文件语法错误（比如 ParseError），整个 autoload 初始化失败，后续所有类都加载不了。
常见误用：把类定义塞进 src/functions.php，又在 psr-4 里配了同名类路径，结果启动就报 Fatal error: Cannot declare class。
-
files数组顺序 =require_once执行顺序，前面的能覆盖后面的函数/常量 - 别在
files里require类文件，它不是类加载入口，只是环境初始化点 - 修改
files后必须重新运行composer dump-autoload，否则变更不生效
dump-autoload -v 输出和 autoload_psr4.php 生成结果之间的偏差——配置写对了，但没执行命令，或执行了却用了缓存旧文件。中文路径本身不构成问题，但编辑器保存编码（如 UTF-8 with BOM）可能让 JSON 解析失败，导致整个 autoload 段被跳过。
