psr-4映射失败最常见原因是命名空间末尾缺反斜杠或路径不匹配：如"app": "src/"错误，正确须为"app\": "src/"，且目录结构、类名大小写、文件位置须严格一致，修改后必须执行composer dump-autoload生效。
psr-4 配置必须匹配命名空间与目录结构
类找不到的最常见原因，是 psr-4 映射里写的命名空间末尾少了反斜杠，或者路径没对齐。比如你写 "App": "src/"，实际 PHP 解析时会把 AppControllerUser 拆成 App + ControllerUser，然后拼出 src/Controller/User.php —— 所以 App 后面那个 不能省，否则就变成前缀匹配，可能误加载其他类。
正确写法必须是：
"autoload": {
"psr-4": {
"App\": "src/"
}
}
-
App\中的双反斜杠是 JSON 字符串转义，最终 PHP 看到的是单个 -
src/必须存在，且目录下要有对应子目录（如src/Controller/） - 类文件名必须和类名完全一致（
UserController.php→class UserController），大小写敏感
新增模块后必须手动运行 composer dump-autoload
Composer 不会监听文件系统变化，改了 composer.json 或新增了类文件，不执行命令就不会生效。很多开发者卡在“明明写了配置，但类还是 not found”，就是因为漏了这步。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 开发中建议先不加
-o：运行composer dump-autoload即可，便于快速验证路径和命名空间 - 上线前再加优化：用
composer dump-autoload -o生成静态映射，跳过运行时解析，提升性能 - 如果用了
autoload-dev（比如测试类），要单独执行一次composer dump-autoload --dev
多个业务模块怎么并存？用多个 psr-4 条目
一个项目常有多个独立模块，比如 Admin、Api、Payment，不需要拆包，直接在同一个 psr-4 里列平级映射即可：
"autoload": {
"psr-4": {
"App\": "src/",
"Admin\": "modules/admin/src/",
"Api\": "modules/api/src/",
"Payment\": "modules/payment/src/"
}
}
- 每个命名空间都必须以
\结尾，路径以/结尾（或至少不以.php结尾） - 模块目录可以不在
src/下，只要路径真实存在、权限可读即可 - 避免嵌套冲突：比如不要同时配
"App\": "src/"和"App\Module\": "src/module/"，后者会被前者覆盖
老代码没命名空间？用 classmap 补救
有些历史模块全是函数或全局类，没有 namespace，PSR-4 完全无效。这时只能靠 classmap 扫描目录，让 Composer 把所有 class 声明都记下来。
"autoload": {
"psr-4": { "App\": "src/" },
"classmap": [ "legacy/", "modules/old-payment/" ]
}
-
classmap路径是相对于composer.json的，不是相对于项目根目录 - 扫描结果写入
vendor/composer/autoload_classmap.php，是纯数组，速度快但不支持动态增删 - 每次增删类文件后，必须重新运行
composer dump-autoload，否则新类不会进映射表 - 别滥用：
classmap会扫描整个目录下所有.php文件，含测试、备份、临时文件，容易引入意外依赖
真正容易被忽略的是 autoload 配置的“作用域隔离”——autoload 和 autoload-dev 彼此完全独立，改了 dev 部分不影响生产加载；而 vendor 目录一旦被移动（比如用 COMPOSER_VENDOR_DIR），所有 require 路径都得同步调整，否则 vendor/autoload.php 就成了死链接。
