psr-4要求命名空间、目录结构、文件名三者逐字符严格一致，仅做字符串前缀匹配；"app": "src/"需对应namespace apphttpcontroller;及src/http/controller/home.php，缺反斜杠、大小写错误或路径不存在均导致class not found。
PSR-4 命名空间必须和文件路径逐字符对齐
Composer 不做语义解析，只做字符串前缀匹配。你写 "App\": "src/"，那所有类文件里 namespace 声明就必须是 App\Http\Controller 这种带双反斜杠、大小写完全一致的格式；写成 appHttpController 或 App/Http/Controller 都不会被加载。
常见错误现象：Class AppHttpControllerHomeController not found，但文件明明在 src/Http/Controller/HomeController.php —— 很可能是因为该文件里写的是 namespace appHttpController;（小写 app）或漏了末尾反斜杠（AppHttpController 缺少结尾 ）。
-
src/目录必须真实存在，不能是拼写错误（如srс/，长得像但不是 c） - Linux 环境下
Http≠http，目录名大小写错一个字母就匹配失败 - PSR-4 映射末尾必须带反斜杠：
"App\": "src/"✅，"App": "src/"❌
classmap 仅用于下划线类名或旧代码迁移
像 Legacy_UserHelper、Old_Core_Utils 这类用下划线分隔的类名，PSR-4 完全无法识别——它只认反斜杠分隔的命名空间。强行塞进 PSR-4 映射只会让类永远找不到。
正确做法是单独用 classmap，并显式扫描对应目录：
"autoload": {
"psr-4": { "App\": "src/" },
"classmap": ["legacy/", "old-lib/"]
}
然后必须运行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer dump-autoload -a
-a 表示强制全量重扫（--classmap-authoritative 是另一回事，别混），否则新增类不会进 vendor/composer/autoload_classmap.php。
-
classmap扫描是递归的，但不支持通配符（"legacy/**/*.php"无效） - 别把
tests/或examples/加进classmap，它们会被无差别收录，膨胀映射表且增加冲突风险 -
classmap性能略低于 PSR-4（因需预加载全部类路径），只推荐用于过渡场景
files 和 autoload-dev 必须隔离，不能混用
files 是全局函数加载机制，不是类自动加载器。它把指定 PHP 文件里的函数“一次性 include”，不参与命名空间解析，也不受 --no-dev 影响。如果你在 files 里写了 helpers.php，那它会在每次请求时被加载，哪怕你加了 --no-dev 也照常执行。
而 autoload-dev 是开发专用映射，比如 "Tests\": "tests/"。一旦用了 composer install --no-dev，这部分规则直接被忽略，里面定义的类也不会进 classmap。
- 误把
tests/加进主autoload块 → 上线后测试类被加载，可能触发调试逻辑或报错 - 在
files里放未加命名空间的工具函数 → 与第三方包同名函数会 fatal error - 多个包都声明了
files加载同名函数文件 → Composer 不合并也不去重，谁后加载谁覆盖
生产部署必须禁用非权威 autoload 查找
线上环境启用 --classmap-authoritative 是防止 autoload 冲突的关键一环。它告诉 autoloader：“所有类都在 autoload_classmap.php 里，别再去文件系统里瞎找”。没有它，PSR-4 规则仍会 fallback 到目录遍历，一旦路径或命名空间有微小偏差（比如多一个空格、少一个反斜杠），就可能加载到错误的类或根本找不到。
验证是否生效：打开 vendor/composer/autoload_classmap.php，搜索你刚加的类全名（如 App\Console\Commands\DeployCommand），确认它在数组里；再检查 vendor/composer/autoload_real.php 中是否调用了 $loader->setClassMapAuthoritative(true)。
- 只加
--optimize-autoloader不加--classmap-authoritative，autoload 仍可能 fallback 到 PSR-4 扫描，冲突隐患没消除 - 本地开发别用
--classmap-authoritative，改了类名或挪了文件，不手动dump-autoload -a就一直Class not found - CI 构建阶段必须确保 PHP 版本、路径分隔符、opcache 配置与线上一致，否则生成的 classmap 在线上无法解析
