composer dump-autoload仅刷新自动加载映射，不修改vendor内容；它读取composer.json/lock中的autoload配置，扫描对应目录生成autoload文件，常见问题源于配置与文件结构不匹配。
composer dump-autoload 会重新生成 autoload 文件，但完全不碰 vendor 里的包
它只读 composer.json 和 composer.lock 中的 autoload 配置（比如 "psr-4"、"classmap"），扫描对应目录下的 PHP 文件，写入 vendor/autoload.php 和 vendor/composer/autoload_*.php。不会下载、解压、安装、更新任何包，也不会修改 vendor/ 下已有的代码。
常见错误现象：
– 手动加了新类或改了命名空间，new Xxx() 报 Class not found，但你其实没漏写 autoload 配置；
– 运行 composer install 或 composer update 后类突然找不到——其实是 autoload 映射没刷新，不是包出问题。
- 用
composer dump-autoload就够了，别顺手敲install白等几分钟 - 加
-o（即--optimize）可生成 classmap 加速加载，适合生产环境；开发时不用，因为 classmap 不自动感知新增文件 - 加
--no-dev可跳过autoload-dev段，减小映射体积（比如测试类不进生产 autoload）
为什么有时候 dump-autoload 不生效？检查这三处
不是命令坏了，而是配置或路径没对上。最常踩的坑是 autoload 声明和实际文件结构不匹配。
-
"psr-4": {"App\": "app/"}要求所有AppXxx类必须在app/Xxx.php或app/Xxx/Yyy.php，不能放在app/Models/Xxx.php却声明为"App\": "app/Models/" - 文件名大小写必须和类名一致（尤其 Linux/macOS），
User.php里写class user会导致 autoload 找不到 - 如果用了
"files"类型 autoload（如全局函数），确保路径是相对于composer.json的，且文件存在、可读
dump-autoload 和 install/update 的关键区别在哪
核心就一条：是否修改 vendor/ 目录内容。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install：按composer.lock拉包 + 写 autoload 映射（相当于dump-autoload+ 安装） -
composer update：重算依赖 + 拉新包 + 删旧包 + 写composer.lock+ 写 autoload 映射 -
composer dump-autoload：只写 autoload 映射，vendor/里一个字节都不动
性能影响：dump-autoload 通常 0.1–0.5 秒；install 在 CI 上可能 20+ 秒；update 更慢，还可能因依赖冲突中断。
CI/CD 或部署脚本里怎么安全地只刷新 autoload
典型场景：代码已通过 git 部署到服务器，vendor 是提前打好包传上去的，此时只需让新类生效。
- 用
composer dump-autoload --no-dev -o，跳过 dev 类、启用优化，避免本地开发配置干扰 - 不要加
--classmap-authoritative，除非你确定所有类都在 classmap 里（它会跳过 PSR 自动发现，漏类直接报错） - 检查返回码：
$?为 0 才算成功；非零说明 autoload 配置有语法错误或路径不存在，得立刻拦停发布
容易被忽略的是：有些项目把 autoload 放在分支特定的 composer.json 里，切分支后忘了 dump-autoload，结果跑着跑着类就丢了。
