composer 的 psr-4 高性能映射（dump-autoload -o）非默认行为，需显式启用；不加 -o 时动态解析类名路径，i/o 开销大，加 -o 后生成静态类名→路径查找表，是生产环境硬性要求。
Composer 的 PSR-4 高性能映射（composer dump-autoload -o）不是“开箱即用”的默认行为，它只在显式启用时生效；不加 -o 就是动态路径拼接，加了才生成扁平化类名→文件路径的静态查找表——这点被很多人当成“可选优化”，实际是生产环境的硬性要求。
为什么 dump-autoload -o 不能跳过
未加 -o 时，Composer 每次加载类都要做字符串解析：把 AppControllersHome 拆成 App + ControllersHome，再按 "App": "src/" 规则拼出 src/Controllers/Home.php。这个过程涉及正则、目录遍历和 file_exists() 调用，I/O 开销明显。
-
-o会生成vendor/composer/autoload_classmap.php，里面是完整类名到绝对路径的键值对数组，加载时直接查表，零解析、零 I/O - CI/CD 流水线里漏掉
-o，测试通过但线上请求延迟陡增，尤其在大量类或慢存储（如 NFS）环境下更明显 -
composer install --optimize-autoloader等价于composer install -o，但仅对依赖包生效；项目自身的psr-4映射仍需手动dump-autoload -o
classmap 和 psr-4 -o 别混用
classmap 是另一种预生成映射机制，但它和 psr-4 -o 的原理不同：前者扫描指定目录下所有 PHP 文件并登记全部类，后者只登记符合 PSR-4 规则的类。两者共存时，Composer 优先走 classmap 查表，但容易引发冲突。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果某类同时满足 PSR-4 路径规则又被
classmap扫到，classmap条目会覆盖 PSR-4 映射——但你改了命名空间或移动文件后，classmap不自动更新，导致旧路径残留 -
classmap路径必须真实存在且可读，否则dump-autoload会静默跳过该条目，不报错也不提示，最终映射缺失 - 除非有特殊需求（比如加载非标准命名的遗留类），否则不要为 PSR-4 类额外配置
classmap；专注写对psr-4+-o就够
Windows 和 Docker 下的 -o 行为一致性
路径分隔符和大小写敏感问题在 -o 模式下会被放大——因为映射表一旦生成就固化，运行时不再做任何路径转换或容错。
- JSON 中必须用正斜杠
/，哪怕在 Windows 上写"src\\"或"src\"都会导致解析失败，dump-autoload会忽略该条目（composer show -s看不到） - PSR-4 映射本身大小写敏感，
-o后更严格：类名AppHelpersStringHelper必须对应src/Helpers/StringHelper.php，文件名写成stringhelper.php或目录名helpers小写，在 Linux 容器里直接Class not found - Docker 构建阶段执行
composer dump-autoload -o时，确保src/目录已 COPY 进镜像；否则生成的 classmap 为空或不全，运行时找不到类
最常被忽略的其实是验证环节：生成 -o 后，别只信“没报错”；用 composer show -s 确认你的命名空间前缀是否列出，再跑一次 php -r "var_dump(class_exists('AppControllersHome'));" 实测加载结果——毕竟 PSR-4 的双向绑定（namespace ↔ path）一旦断开，-o 只会让错误更快发生，而不是修复它。
