vendor/autoload.php由composer install/update末尾自动生成，仅引入autoload_real.php并调用getloader()，不包含映射逻辑；手动修改会被覆盖，且必须在入口文件首行引入才能生效。
composer install 不是“装完就完事”的命令，它生成的 vendor/autoload.php 能否正常工作，取决于你是否理解它的生成逻辑、触发条件和加载路径。多数类找不到、Class not found 错误，根本原因不在代码写错，而在 autoload 文件没按预期更新或加载方式不对。
composer install 什么时候会生成/更新 autoload.php
它只在以下情况生成或刷新 vendor/autoload.php：
- 首次运行
composer install（且项目无vendor/目录）时，从composer.lock安装依赖并生成 autoload 入口 - 已有
vendor/但composer.lock与vendor/内容不一致时，会重新安装并重建 autoload 文件 - 如果仅修改了
composer.json中的autoload配置（比如加了新的 PSR-4 映射），composer install不会主动重生成映射表——必须显式执行composer dump-autoload
换句话说：install 管依赖安装和锁文件一致性，不管 autoload 配置变更。改了命名空间映射却没跑 dump-autoload，类照样加载失败。
autoload.php 本身不包含映射逻辑，只是个“转发器”
vendor/autoload.php 文件极简，核心就两行：
require_once __DIR__ . '/composer/autoload_real.php'; return ComposerAutoloaderInitXXXX::getLoader();
它真正起作用的是 vendor/composer/autoload_real.php 和下面几个关键映射文件：
-
autoload_classmap.php：纯数组映射，O(1)查找，需composer dump-autoload -o生成 -
autoload_psr4.php：PSR-4 规则映射，如["App\"]=>["src/"]，动态解析路径 -
autoload_files.php：列出所有要提前require的函数文件（如 helpers.php）
如果你在调试时发现某个类没被加载，别急着查 autoload.php，直接打开 vendor/composer/autoload_psr4.php 看对应命名空间是否已写入；若没出现，说明 dump-autoload 没执行，或 composer.json 里配置格式有误（比如漏掉结尾反斜杠 App）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
PSR-4 映射失效的三个高频原因
即使配置写了、dump-autoload 也跑了，类仍可能加载失败：
- 命名空间声明与文件路径不严格匹配：例如配置
"App\": "src/"，但类定义为namespace AppControllers;，而文件实际放在src/controllers/UserController.php（目录名小写）——PSR-4 区分大小写，Linux 下直接失败 - 文件扩展名不是
.php：Composer 默认只扫描.php后缀，.inc或.class.php不会被纳入 PSR-4 映射 - 类名含非法字符或与文件名不一致：如
UserController.php里定义了class UserControllerV2，自动加载器按文件名推导类名，必然失败
验证方法很简单：在终端执行 composer show --path App\Controllers\UserController（假设类存在），它会输出该类应映射到的绝对路径；如果报错或路径不对，问题就出在映射规则或文件位置上。
生产环境必须加 -o 参数优化 autoload
开发阶段用 PSR-4 动态解析没问题，但生产环境每次请求都要做字符串分割+目录拼接，开销明显。开启优化后：
-
composer install --optimize-autoloader或composer dump-autoload -o - Composer 把所有可发现的类（包括 vendor 中符合 PSR 的类）预扫描进
autoload_classmap.php - 自动加载器优先查 classmap，命中即
require，跳过全部路径解析逻辑
注意：-o 会忽略 files 类型的自动加载项（因为它们本就不该进 classmap），且无法识别动态生成的类（如运行时写入的临时类）。所以不要在 CI/CD 流程里盲目加 --no-dev -o 后就不管了——先确认你的 autoload.files 是否真不需要。
最常被忽略的一点：autoload 文件的生成时机和生效范围是分离的。vendor/autoload.php 是入口，但它背后依赖的映射文件（尤其是 autoload_classmap.php）可能很久没更新；而开发者往往只记得改代码、改配置，却忘了让 Composer “重新看见”这些变化。
