PSR-4映射失败主因是命名空间前缀缺双反斜杠（如"App\"）或路径不匹配，导致Composer无法正确拼出文件路径；修改composer.json后必须执行composer dump-autoload更新映射表，否则仍使用旧配置。
PSR-4 映射失败？检查命名空间结尾反斜杠和路径对齐
PSR-4 不是模糊匹配，它严格按 namespace 前缀 + 目录路径拼出文件路径。比如你写 "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"（缺尾部/）→ 部分版本仅警告，但映射仍可能不生效
classmap 扫不到无命名空间的类？确认 Composer 版本与扫描行为
Composer 2.0+ 默认跳过不含 namespace 声明的 PHP 文件，哪怕你写了 "classmap": ["legacy/"]，legacy/Database.php 里只有 class Database { }，也不会被索引。
这不是配置错，而是行为变更。能绕过的方式极有限：
- 降级到 Composer 1.x（不推荐，安全与兼容性风险高）
- 手动加
namespace声明（哪怕空的namespace;），让文件被识别 - 改用
files字段显式引入——这是唯一稳定方案，但仅适用于单个类文件或函数集合
注意：classmap 扫描时不会报错，也不会提示“跳过裸类”，只会静默忽略。
files 能否加载类？不能，重复定义会直接 fatal error
files 的作用是每次请求时 require_once 指定文件，它不参与类查找流程，只是静态包含。如果你把 User.php（含 class User { }）塞进 files，一运行就报 Fatal error: Cannot declare class User。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
只适合这类内容：
- 纯函数文件，如
src/helpers.php - 常量定义，如
config/constants.php - 必须提前执行的初始化逻辑（但别放耗时操作）
路径必须相对于 composer.json，不能写 "helpers.php" 这种相对当前目录的简写。
混用 PSR-4 和 classmap 时，为什么新类总走老路径？
Composer 加载顺序固定：先查 psr-4，再查 psr-0（已废弃），最后 fallback 到 classmap 和 files。这意味着只要类名匹配某个 psr-4 规则，哪怕那个映射指向一个不存在的文件，Composer 也会尝试加载它，而不会退到 classmap 中同名的类。
典型现象：
- 你删了
app/User.php，但"App\": "app/"还在composer.json里 - 调用
new App\User()时，Composer 仍试图 requireapp/User.php，报Class not found，而不是去查classmap里注册的User
所以，要让 classmap 生效，得确保对应类名**完全不匹配任何 psr-4 前缀**——要么改命名空间，要么删掉冲突的 psr-4 条目。
最易被忽略的是：改完 composer.json 后，必须手动运行 composer dump-autoload，否则旧映射还在 vendor/composer/autoload_classmap.php 里，错误表现会从 “Class not found” 变成更底层的 require(): failed to open stream。
