运行 composer dump-autoload 可重新生成自动加载映射，仅在新增/移动类文件、修改 PSR-4 路径或添加 files 加载项时需手动执行；常用参数包括 --dev（含开发类）、-o（优化模式，禁用 files）、-a（强制重生成）；PSR-4 要求路径与命名空间严格匹配且文件名大小写敏感。

直接说结论：运行 composer dump-autoload 就能重新生成自动加载映射，但多数时候你根本不需要手动执行它——Composer 在 install/update 时已自动完成。

什么时候必须手动运行 composer dump-autoload

只有在你**没改 composer.json，但新增/移动了类文件、修改了 PSR-4 映射路径、或加了新的 files 全局加载项**时，才需要手动触发。比如你刚写完一个新类 src/Helper/StringUtils.php，但 vendor/autoload.php 还不认识它——这时 dump 才起作用。

• 改了 "autoload": {"psr-4": {...}} 但没 run composer update 或 install
• 新增了 "autoload": {"files": ["src/helpers.php"]} 这类文件加载配置
• 开发中频繁增删类，又不想每次跑 composer install（太重）
• composer.json 没变，但 IDE 或运行时提示 Class not found，且确认命名空间和路径无误

composer dump-autoload 的常用参数差异

默认命令只处理 autoload 段，不碰 autoload-dev；但测试类常放 dev 下，漏掉就会报错。

• composer dump-autoload：只生成生产环境映射（autoload）
• composer dump-autoload --dev：同时包含 autoload-dev（如 tests/ 下的类）
• composer dump-autoload -o：启用“优化模式”，把所有类路径扁平化为静态数组，提升加载速度（适合生产部署）
• composer dump-autoload -a：强制重生成全部映射，忽略缓存（极少数情况映射卡住时用）

常见坑：-o 不支持 files 加载项，用了会静默跳过——如果依赖 helpers.php 这类全局函数，别加 -o。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

为什么有时运行了还是 Class not found？

不是命令没生效，而是自动加载机制本身有前提条件，容易被忽略。

• PSR-4 要求目录结构严格匹配命名空间：比如 "App\": "src/"，那 AppHttpControllersHomeController 必须在 src/Http/Controllers/HomeController.php
• 文件名必须和类名一致（大小写敏感！Linux 下 homecontroller.php 加载不了 HomeController）
• 没执行 require 'vendor/autoload.php'，或执行位置不对（比如在 require 前就 new 类）
• 使用了符号链接（symlink）到 src，但 Composer 默认不扫描软链目录（需加 --optimize-autoloader 或改配置）

开发中更轻量的替代方案

如果你只是临时加几个类、不想碰 Composer，且项目用 PSR-4，其实可以绕过 dump：

• 直接在 composer.json 的 autoload.files 里加单个文件路径，再跑一次 dump-autoload（比改 PSR-4 更快）
• 用 class_alias() 或 spl_autoload_register() 手动注册——仅限调试，别进 Git
• 某些 IDE（如 PHPStorm）能“Reload project from composer.json”，它会触发 dump，但不等于运行时有效

真正容易被忽略的是：Composer 的 autoload 映射是**静态生成的**，它不会监听文件变化。你删了一个类，映射里还留着路径，直到下次 dump —— 所以 CI 流程里建议每次部署都加 composer dump-autoload -o，而不是信“上次生成的还热乎”。