PSR-4映射不生效需先检查命名空间结尾双反斜杠\和路径是否对齐，如"App\": "app/"才合法；漏\、路径多层嵌套、以/开头或无尾部/均导致静默失效；classmap仅适用于无命名空间类，files用于全局函数/常量。
PSR-4 映射不生效？先检查命名空间结尾的 \ 和路径是否对齐
PSR-4 不是“自动猜路径”，它靠命名空间前缀和目录路径拼接出文件位置。比如你写 "App\": "app/"，Composer 会把 App\User 解析为 app/User.php；但若漏掉结尾的反斜杠写成 "App"，JSON 解析后变成普通字符串，映射静默失效——类找不到，也不会报错。
常见翻车点：
-
"App\": "app/App/"→ 错误：这会让App\User去找app/App/User.php，而实际文件在app/User.php -
"App\": "/app"→ 错误：以/开头被当绝对路径，Composer 直接忽略该条目 -
"App\": "app"（没斜杠）→ 部分 Composer 版本会警告，但映射仍可能失败
classmap 是加载非命名空间类的唯一可靠方式
没有命名空间、类名和文件名不一致（比如 database.inc 里定义了 class DB），PSR-4 和 PSR-0 都无能为力。这时必须用 classmap，它不看命名空间，只扫描你指定路径下所有 PHP 文件，提取 class、interface、trait 声明并生成硬编码映射表。
配置要点：
- 路径必须相对于
composer.json所在目录，支持目录（如"legacy/"）、具体文件（如"lib/Utils.php"）、甚至 glob（如"src/*.inc"） - 别写
"classmap": ["."]—— 会扫进vendor/和tests/，导致映射表臃肿、加载变慢、同名类冲突 - 删了类文件后，必须重跑
composer dump-autoload，否则旧路径仍留在vendor/composer/autoload_classmap.php中，错误提示会从Class not found变成更底层的require(): failed to open stream
files 配置用于全局函数或常量，不是类加载方案
如果某个 .php 文件里没定义类，只写了 function helper() 或 define('API_URL', ...)，classmap 完全无效。这时得靠 files 字段：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
它会在每次加载 vendor/autoload.php 时无条件 include_once 列出的文件。示例配置：
"autoload": {
"files": ["src/helpers.php", "config/constants.php"]
}
注意：files 不做任何解析，也不支持 glob；路径同样需相对 composer.json；且一旦加入，每次请求都会执行这些文件——别把耗时逻辑放进去。
PSR-4 和 classmap 混用时，顺序陷阱很隐蔽
Composer 查找类的顺序确实是“先 PSR-4，再 classmap”，但关键在于：PSR-4 匹配是“前缀匹配 + 路径存在性检查”，不是“全名精确匹配”。比如你配置了 "MyLib\": "legacy/src/"，又在 legacy/old_lib/ 里用 classmap 加载 LegacyDB 类，但某处写了 new MyLib\LegacyDB()，Composer 会先去 legacy/src/LegacyDB.php 找——哪怕这个文件根本不存在，也不会 fallback 到 classmap。
所以混用时务必保证：
- PSR-4 命名空间前缀不意外覆盖
classmap中的类名（比如避免"Legacy\": "legacy/"这种宽泛前缀） - 老类尽量用独立命名空间隔离，或干脆全走
classmap，不掺 PSR-4 - 运行
composer dump-autoload -o后，检查vendor/composer/autoload_psr4.php和autoload_classmap.php是否都生成了预期条目
最易被忽略的是：修改 composer.json 后，有人习惯性跑 composer install，但开发阶段只需 dump-autoload；install 不触发 autoload 重建，改了也白改。
