生产环境必须用 composer install --no-dev --optimize-autoloader --classmap-authoritative，因为 dump-autoload -o 不生成 classmap 文件，仅刷新 autoload_static.php 和 PSR-4 映射；完整 classmap 仅在 install/update 阶段构建，且需显式配置 classmap 或依赖自动扫描，配合 --classmap-authoritative 才能启用权威加载并杜绝 fallback。
生产环境必须用 composer install --no-dev --optimize-autoloader --classmap-authoritative，换镜像源、跑 dump-autoload -o 或只加 "optimize-autoloader": true 都不解决问题。
为什么 dump-autoload -o 在生产部署里基本没用
它不重建 vendor/composer/autoload_classmap.php，只刷新轻量级的 autoload_static.php 和 PSR-4 映射表。真正的 classmap 文件只在 install 或 update 阶段生成 —— 这是 Composer 2.9.6 的底层行为，不是配置漏了或命令写错了。
- 执行后检查
vendor/composer/autoload_classmap.php：文件不存在、大小为 0、或只有几十行 → 没生效 - 即使存在，若
composer.json里没显式声明"classmap"数组，Composer 2.x 默认跳过扫描，-o就是空转 - PHP 7.4+ 下全量 classmap 常达 2–5 MB，每次请求反序列化整个数组，而实际只用到不到 5% 的类，反而拖慢冷启动
composer install --optimize-autoloader 到底做了什么
这是唯一能触发完整 classmap 构建流程的命令：读取 composer.lock，安装包，扫描所有启用的 autoload 配置（psr-4、classmap、files），并确保生成的 classmap 被 vendor/autoload.php 正确引用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须搭配
--no-dev：否则require-dev中的测试类、Mock 类、示例代码会被一并扫进 classmap，污染映射表 - 镜像源（如阿里云、腾讯云）只影响下载速度和稳定性，不参与 classmap 生成逻辑 —— 换镜像不会让 autoload 变快
- CI/CD 流水线中不能依赖本地
dump-autoload补救，必须固化这条 install 命令
--classmap-authoritative 不是加速开关，是断电式加载
它让自动加载器彻底放弃 fallback：类不在 classmap 里就立刻抛 Class not found，不拼路径、不 file_exists()、不遍历目录。报错不是配置错了，是 classmap 漏了类。
- 常见漏类场景：
"App": "app/"缺末尾反斜杠 → 应为"App\": "app/" - 新增
app/Console/Commands/DeployCommand.php，但命名空间写成namespace AppConsoleCommands;（中间缺） - 用了
"files": ["app/Helpers/functions.php"]加载全局函数 —— 这类文件不会进 classmap，开了--classmap-authoritative后仍能加载，但容易误判为 autoload 整体失效
验证优化是否真正生效的关键动作
别只看命令有没有报错，得查文件和代码两处：
- 运行
composer install --no-dev --optimize-autoloader --classmap-authoritative后，检查vendor/composer/autoload_classmap.php是否存在且含几千个类路径 - 打开
vendor/composer/autoload_real.php，搜addClassMap—— 若没调用，说明 classmap 根本没加载 - 运行
php -r "require 'vendor/autoload.php'; var_dump(class_exists('AppHttpControllersHomeController'));"，再删掉该类对应文件测试：若仍返回true，说明 fallback 还在工作，--classmap-authoritative没生效
最常被忽略的是：classmap 生成依赖于 composer.lock 和代码版本严格匹配，git checkout 必须在 composer install 之前完成，否则线上可能降级关键包。
