composer install --optimize-autoloader 是唯一能完整生成 autoload_classmap.php 的命令，因 dump-autoload -o 在 Composer 2.x+ 中默认跳过 classmap 扫描，仅更新静态映射文件；若 CI/CD 中仅执行后者且复用 vendor，classmap 将长期陈旧。
composer install --optimize-autoloader 为什么必须用，而不是 dump-autoload -o
因为 composer install --optimize-autoloader 是唯一能真正生成并写入 vendor/composer/autoload_classmap.php 的命令；composer dump-autoload -o 在 Composer 2.x+ 中默认跳过 classmap 扫描，只重写 autoload_static.php 和 autoload_psr4.php，对 classmap 文件完全无影响。
常见错误现象：执行 dump-autoload -o 后发现 autoload_classmap.php 文件体积没变、内容陈旧，甚至根本不存在——说明 classmap 根本没重建，优化只是“假动作”。
-
install --optimize-autoloader会触发完整 autoload 构建流程：扫描所有启用的 autoload 类型（psr-4、classmap、files），生成最终 classmap 数组 -
dump-autoload -o默认只刷新 PSR-4 映射表，除非你显式加了--classmap-authoritative或项目里定义了"classmap"配置项，否则它不碰 classmap - CI/CD 流水线中若只跑
dump-autoload -o，而 vendor 目录是缓存复用的，那 classmap 就永远停留在上次install或update时的状态
PSR-4 配置写错一个反斜杠，autoload 就失效
PSR-4 前缀必须以反斜杠结尾，"App": "src/" 正确，"App": "src/"（缺反斜杠）或 "App\": "src/"（双反斜杠是字符串转义，实际值仍为单反斜杠）在新版 Composer 中可能静默失效或匹配失败。
路径末尾也必须带斜杠："src" 会导致拼出 srcControllerHome.php，而 "src/" 才会拼出 src/Controller/Home.php。
- 命名空间
AppControllerHome去掉前缀App得到ControllerHome，再把替换为/→Controller/Home，最后拼上路径src/→src/Controller/Home.php - Linux 下大小写敏感：文件名
HomeController.php里必须定义class HomeController，不能是homecontroller或HomeController（首字母小写） - 子命名空间必须体现为子目录：
AppUtilsHelper对应src/Utils/Helper.php，不是src/utils/helper.php（路径大小写也需一致）
开了 --classmap-authoritative 就 Class not found？先查这三处
--classmap-authoritative（或 -a）不是“加速开关”，而是“严格模式开关”：它让 Composer 彻底跳过 fallback 查找，类不在 autoload_classmap.php 里就直接抛错，不再尝试按 PSR-4 拼路径、不调 file_exists()、不遍历目录。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
报错不是配置错了，是 classmap 漏了类。常见漏类场景：
-
"App": "app/"缺末尾反斜杠 → 应为"App"，导致扫描失败，app/Console/Commands/DeployCommand.php不进 classmap - 新增类文件但命名空间写错，比如
namespace AppConsoleCommands;（缺分隔符），而 PSR-4 配置是"App": "app/" - 误把
tests/、examples/路径塞进了psr-4或classmap配置，导致 classmap 膨胀且真实业务类被挤出或扫描遗漏
require 'vendor/autoload.php' 必须放在入口第一行
vendor/autoload.php 的作用不是“定义类”，而是立即调用 ClassLoader::getLoader()，通过 spl_autoload_register() 把 PSR-4、classmap、files 等加载逻辑注册进 PHP 的 autoload 队列。
PHP 在解析到 new SomeClass() 或 use SomeClass 时，会立刻触发 autoload 队列——如果此时还没执行 require，队列为空，直接报 Class not found，且不重试。
- 不能包在
if、函数体、try/catch里：PHP 解析阶段就触发 autoload，作用域还没进函数 - CLI 脚本中写成
./vendor/autoload.php很危险：当前工作目录不一定是项目根目录，路径失效 - 正确写法是：
require __DIR__ . '/vendor/autoload.php';（入口文件第一行）
删掉 vendor/composer/ 目录后，vendor/autoload.php 还在，但运行时报错——因为“调度中心”还在，而“地图”（autoload_psr4.php、autoload_classmap.php 等）全没了。
