生产环境必须用 composer install --no-dev --optimize-autoloader，因其唯一能完整扫描所有 autoload 配置并生成有效 classmap；dump-autoload -o 不重建 autoload_classmap.php，仅刷新轻量映射，在 composer 2.x + php 7.4+ 下基本无效甚至拖慢冷启动。
生产环境必须用 composer install --no-dev --optimize-autoloader，不是 dump-autoload -o
后者在 Composer 2.x + PHP 7.4+ 下基本无效，甚至拖慢冷启动。它不重建 vendor/composer/autoload_classmap.php，只刷新轻量映射（如 autoload_static.php 和 PSR-4 查找表）。classmap 文件只在 install 或 update 阶段生成——这是 Composer 的底层行为，不是 bug。
常见错误现象：dump-autoload -o 执行后 autoload_classmap.php 没更新、体积仍很小、甚至根本不存在，说明 classmap 根本没触发构建。
-
composer install --no-dev --optimize-autoloader是唯一能完整扫描所有启用 autoload 配置（PSR-4、classmap、files）并生成可用 classmap 的命令 -
--no-dev不仅删掉require-dev包，还会让 Composer 完全忽略它们的 autoload 规则，避免测试类污染 classmap - CI/CD 流水线里必须固化这一行命令，不能依赖本地
dump-autoload
--classmap-authoritative 开了就报 Class not found？先查这三处
这个参数不是“加速开关”，而是“断言模式”：类不在 classmap 里就直接抛错，不再 fallback 到 PSR-4 拼路径。报错不是配置错了，是 classmap 漏了类。
-
"App": "app/"缺末尾反斜杠 → 应为"App\": "app/"，命名空间扫描失败 - 新增了
app/Console/Commands/DeployCommand.php，但类名是class DeployCommand，而命名空间却是namespace AppConsoleCommands;（缺分隔符） - 误把
tests/、examples/路径塞进了psr-4或classmap，导致 classmap 膨胀且漏掉真实类
验证方式：打开 vendor/composer/autoload_classmap.php，搜你刚加的类全名（如 AppConsoleCommandsDeployCommand），看是否在数组里。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
为什么 autoload_classmap.php 变大 ≠ 优化生效？
文件体积暴涨（几 MB）、内容全是路径字符串，大概率是白忙——说明 classmap 里混进了大量无用路径（比如 tests/、docs/），实际请求时反而要反序列化更多数据，比 PSR-4 拼路径更慢。
- 检查
composer.json中"autoload"块，删掉无效项："docs/": ["docs/"]、"tests/": ["tests/"]、"": ["lega"]等 - 合并冗余 PSR-4 前缀：
"AppHttpControllers": "app/Http/Controllers/"和"AppHttpMiddleware": "app/Http/Middleware/"改成"AppHttp": "app/Http/" - 确认
autoload_classmap.php是否真被加载：打开vendor/autoload.php，搜索addClassMap—— 必须看到类似$loader->addClassMap(require __DIR__ . '/composer/autoload_classmap.php');这一行
opcache 配置漏掉 opcache.enable_cli=1，前面全白做
很多人开了 opcache.enable=1，但忘了 opcache.enable_cli=1。这会导致 composer install 生成的 autoload_classmap.php 文件无法被 opcache 缓存——每次请求都得重新解析那个几 MB 的数组，反而比不优化更慢。
- 必须同时开启：
opcache.enable=1、opcache.enable_cli=1、opcache.revalidate_freq=0 - 验证方式：执行
php -d opcache.enable=1 vendor/autoload.php，再运行var_dump(opcache_get_status()['scripts'])，看里面有没有vendor/composer/autoload_classmap.php -
"optimize-autoloader": true和"classmap-authoritative": true要写在composer.json的"config"块里，不是"autoload"段；否则某些 Composer 版本（尤其是 2.2+）可能忽略
真正卡点不在命令怎么敲，而在 classmap 是否干净、opcache 是否真缓存了它、以及 autoloader 是否跳过了 runtime 查找——这三个环节漏一个，优化就悬在半空。
