composer dump-autoload是重写自动加载映射文件而非刷新缓存；仅当新增类、修改autoload配置、切换Git分支导致映射未同步，或执行--no-autoloader后，才需手动运行。
直接执行 composer dump-autoload 就能重建自动加载索引，但多数报错或失效问题出在 autoload 配置错误、PSR 规则不匹配或未触发重生成场景上。
什么时候必须运行 composer dump-autoload
不是每次改完代码都要手动执行——Composer 通常在 install 或 update 后自动完成。只有以下情况才需要手动触发：
- 新增了自定义
psr-4或psr-0命名空间映射，且没运行过install/update - 修改了
composer.json中的autoload或autoload-dev字段 - 添加了新的
files类型全局函数文件，但vendor/autoload.php还没加载它们 - 切换 Git 分支后发现类找不到，而
vendor/没变（说明 autoload map 没同步更新）
dump-autoload 的常用参数组合
默认命令只生成优化后的 classmap（适用于生产），但开发中常需更灵活的控制：
-
composer dump-autoload：生成 classmap + PSR 映射，跳过文件扫描（快，但可能漏新文件） -
composer dump-autoload -o：强制优化 classmap（合并所有类路径为一张静态数组，提升性能，但不支持动态路径） -
composer dump-autoload --no-optimize：禁用 classmap，只靠 PSR 规则实时解析（适合开发调试，能立刻响应新文件） -
composer dump-autoload -a：同时处理autoload和autoload-dev（默认只处理主 autoload）
注意：-o 会忽略 files 和部分动态 PSR-4 路径（比如含通配符的），线上用前务必验证类是否真能加载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见失败原因和对应检查点
执行后仍报 Class not found，大概率不是命令没跑，而是配置或结构出问题：
-
composer.json里autoload.ps r-4的路径写成相对 vendor 的路径（如"App\": "src/"是对的，"App\": "../src/"会失败） - 目录实际结构与命名空间不一致（例如声明
"App\Controller\": "src/Controllers/"，但真实路径是src/Controller/，少了个s） - PHP 文件没按 PSR-4 规则命名：类名
UserRepository必须放在UserRepository.php，且文件内class UserRepository—— 名称大小写不一致在 Linux 下直接失败 - 运行命令时不在项目根目录（即
composer.json所在目录），会导致读不到配置
可临时加 -v 参数看详细日志：composer dump-autoload -v，它会打印扫描了哪些目录、跳过了哪些文件。
为什么有时删 vendor/autoload.php 没用，但删 vendor/composer/autoload_*.php 才生效
因为 vendor/autoload.php 只是个入口引导文件，真正映射逻辑存在 vendor/composer/autoload_classmap.php、autoload_psr4.php 等中间文件里。手动删 autoload.php 不影响这些缓存文件，所以重建索引必须走 dump-autoload，而不是靠删入口文件“刷新”。
顺带一提：composer install --no-autoloader 或 update --no-autoloader 会跳过生成 autoload 文件，这种情况下必须显式补上 dump-autoload，否则整个自动加载链就断了。
