psr-4 是最常用也最容易写错的自动加载方式，要求命名空间与目录结构严格对应，末尾斜杠、src/ 子目录、反斜杠结尾及前缀不重叠均需准确；classmap 适用于非标准结构或性能敏感场景，需配合 --classmap-authoritative 使用；autoload-dev 必须分离测试代码；优化核心是删冗余、控范围，线上部署应使用 --no-dev --optimize-autoloader。
psr-4 是最常用也最容易写错的 autoload 方式
Composer 默认推荐 psr-4，但它对目录结构和命名空间有严格对应关系：namespace 必须完全匹配 vendor/name/src/ 下的子路径。常见错误是路径末尾多加了 / 或少写了 src/，比如写成 "App\": "src"（缺斜杠）或 "App\": "src/"（多余斜杠），会导致 Class not found 且不报 autoload 错误，只默默跳过。
正确写法必须确保：
-
"App\": "src/"—— 注意末尾斜杠，且src/目录下要有App/子目录才能加载AppFooBar - 命名空间结尾必须带反斜杠
，否则 Composer 会当成不完整前缀，匹配失效 - 多个 psr-4 映射不能有前缀重叠，否则后定义的会被忽略（Composer 不合并，只覆盖）
classmap 适合非标准结构或性能敏感场景
classmap 不依赖命名空间或文件名规则，而是扫描指定目录下所有 .php 文件并记录类名到路径的映射。它适用于：
- 遗留代码，类名和文件路径无规律（比如
class DBUtil在lib/db_tools.php） - 需要极致加载速度的 CLI 工具或高并发脚本（避免每次 require 前的路径解析和命名空间转换）
- 包含大量 interface/trait 的项目，它们本身不被 psr-4 自动发现（除非显式 new 或 use）
生成方式很简单：composer dump-autoload --classmap-authoritative。注意加 --classmap-authoritative 后，Composer 将**完全忽略自动发现逻辑**，只查 classmap —— 这能提速，但要求所有类都必须被扫描到，漏掉一个就 Class not found。
autoload-dev 和 production autoload 要分开配置
测试类、Mock、Factory 等开发期才用的代码，绝不能进生产 autoload。否则会增大 autoloader 映射表、拖慢首次请求，还可能暴露测试逻辑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确做法是用 autoload-dev 单独声明：
"autoload-dev": {
"psr-4": {
"Tests\": "tests/"
}
}
这样执行 composer install --no-dev 时，Tests\ 映射根本不会写入 vendor/composer/autoload_psr4.php。而如果你把测试代码塞进主 autoload 里，即使加了 --no-dev，这些映射依然存在，只是对应文件不被安装 —— autoloader 还是会尝试查找，徒增开销。
优化不是堆配置，而是删冗余 + 控范围
很多人以为加更多 classmap 或拆更细的 psr-4 前缀就是优化，其实反而容易引入冲突和维护成本。真正有效的优化点很朴素：
- 删掉没用的 autoload 配置项（比如注释掉但没删除的旧映射）
- 限制
classmap扫描路径为最小集合，避免"classmap": ["."]这种暴力扫描（会吃 CPU、生成超大映射表） - 确认
vendor/composer/autoload_classmap.php里没有重复类名（两个路径映射同一个类，后者覆盖前者，但你未必知道） - 线上部署务必用
composer install --no-dev --optimize-autoloader，后者会触发classmap生成并启用authoritative模式
classmap 的“快”是有代价的：一旦新增类但忘记重新 dump，就会直接失败。这个边界比 psr-4 更硬，也更容易在 CI/CD 流程里被忽略。
