composer dump-autoload 仅在修改类文件位置、新增类或更改 composer.json 中 autoload 配置时才需执行；修改类内部逻辑无需运行。
composer dump-autoload 什么时候才真正写入新映射
它只在你改了类文件位置、新增类、或动了 composer.json 里的 autoload 配置后才需要执行；改类内部逻辑、修 bug、调方法参数，完全不用跑。
常见误判场景：
- 新增了
app/Console/Commands/DeployCommand.php，但没运行composer dump-autoload→new DeployCommand()报Class not found - 把命名空间从
AppHttpControllers改成AppActions，但只改了 PHP 文件，没同步更新composer.json中的psr-4映射 → 即使跑了dump-autoload，类依然找不到 -
composer.json格式错误（比如多逗号），dump-autoload会静默失败，建议加-v查看详细输出
composer dump-autoload -o 在 PHP 7.4+ 和 Composer 2.x 中基本不生效
它不会重建 vendor/composer/autoload_classmap.php，只是“重写”已有 classmap —— 如果该文件压根不存在，或上次 install 后没变过，-o 就是空转。
真正生成/刷新 classmap 的时机只有两个：composer install 和 composer update。而 dump-autoload 默认跳过 classmap 扫描，除非项目里明确定义了 "classmap" 字段，或你额外加了 --classmap-authoritative。
所以这些操作都无效：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer dump-autoload -o单独用于生产部署 - 在 CI 脚本里写
composer install --no-dev && composer dump-autoload -o - 依赖
"optimize-autoloader": true写在composer.json里自动生效
真正该用的命令是 composer install --optimize-autoloader
这个命令会强制重新扫描所有 autoload 配置项（PSR-4、files、classmap），生成完整 autoload_classmap.php，并跳过 vendor 缓存逻辑，确保映射与当前代码严格一致。
生产环境部署必须写死这一条：
-
composer install --no-dev --optimize-autoloader（推荐） - 如需彻底禁用 fallback，再加
--classmap-authoritative，但前提是确认没有files加载、没有动态注册类、且所有 PSR-4 命名空间末尾都有反斜杠（如"App\": "app/"） - 不要在本地开发长期开
--optimize-autoloader，它会掩盖命名空间拼错、路径配置错等真实问题
验证 classmap 是否真被加载和使用
别只看命令有没有报错，要查实际效果：
- 打开
vendor/composer/autoload_classmap.php，搜你的主命名空间（如App\），确认对应路径是绝对路径数组，不是空数组或只有 vendor 条目 - 用
strace -e trace=stat php -r "new AppModelsPost();"观察是否还有大量stat("/path/to/app/Models/Post.php")失败调用；没了，说明 fallback 已关闭 - 如果用了 OPcache，检查
opcache_get_status()['preload_statistics']是否包含autoload_static.php，而不是靠autoload_classmap.php—— 后者体积大、结构动态，OPcache 很难高效缓存它
classmap 不是越大越好；一个几 MB 的 autoload_classmap.php，每次请求都要完整 require 并反序列化，而单次请求通常只用到其中不到 5% 的类——这比 PSR-4 拼路径更吃资源。
