vendor/autoload.php 是引导入口，真正起作用的是 spl_autoload_register() 注册的加载函数及 autoload_ps4.php 中的硬编码映射表；常见错误是漏引该文件导致 Class not found。
vendor/autoload.php 是启动器，不是配置文件
它本身不包含任何映射逻辑，只是一个引导入口。真正起作用的是它内部调用的 spl_autoload_register() 注册的加载函数，以及从 vendor/composer/autoload_psr4.php 等生成文件中读取的硬编码映射表。
常见错误现象：Class not found，但类文件明明存在、命名空间也对——大概率是漏掉了 require_once 'vendor/autoload.php'; 这一行，导致整个自动加载链根本没注册。
实操建议：
- 入口文件（如
public/index.php）第一行必须是require_once __DIR__.'/../vendor/autoload.php';，不能晚于任何类使用 - 不要手动修改
vendor/autoload.php或vendor/composer/autoload_psr4.php：它们每次composer dump-autoload都会被重写 - 调试时可临时加一句
var_dump(class_exists('AppControllerHome'));，确认是否真进入加载流程
PSR-4 映射靠 composer.json 配置 + dump-autoload 生成
Composer 不“猜”路径，只查表。这张表的内容完全由 composer.json 的 "autoload": {"psr-4": {...}} 字段决定，且必须执行 composer dump-autoload 才会写入生成文件。
容易踩的坑：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"App": "src/"必须结尾带斜杠，写成"App": "src"会导致拼出srcControllerHome.php而非src/Controller/Home.php - 命名空间必须以反斜杠结尾才被识别为前缀，
"App\": "src/"正确，"App": "src/"在新版 Composer 中静默失效 - 改完
composer.json后不运行composer dump-autoload，等于什么都没做；CI/CD 流水线里也要确保这步被执行
类文件路径 = 命名空间去前缀 + 目录拼接 + .php
比如配置 "App\": "src/"，类 AppControllerUserService 就严格对应 src/Controller/UserService.php。中间没有容错，大小写、目录层级、文件后缀全要一致。
典型问题场景：
- Linux 下
UserService.php里写了class userservice→ 找不到（类名大小写必须完全匹配） -
src/Controller/User.php里声明namespace AppControllers;→ 找不到（应为AppController，多一个s就断链） - 想把
AppUtilsHelper放进src/utils/helper.php→ 不行，PSR-4 要求子命名空间必须体现为子目录，正确路径是src/Utils/Helper.php
dump-autoload -o 会固化 classmap，开发阶段慎用
composer dump-autoload -o 会生成优化后的 autoload_classmap.php，把所有类路径打成一张静态数组，跳过 PSR-4 的字符串处理，性能略高。但它会忽略新增类——除非你再次执行该命令。
这意味着：
- 本地开发时新增了
AppServiceLogger，忘了再跑dump-autoload→ 类直接不可见 - CI 环境若用了
-o，又依赖 dev-only 的 autoload-dev 配置，可能因 classmap 不含这些路径而报错 - 调试阶段建议只用
composer dump-autoload（无-o），确保每次变更都实时生效
最常被忽略的一点：PSR-4 映射生效的前提，是命名空间前缀和路径配置在 composer.json 中完全合法，且 dump-autoload 成功执行——这两者缺一不可，少一个，vendor/autoload.php 就只是个空壳。
