composer dump-autoload 是重写自动加载映射文件而非刷新缓存；仅当新增类、移动类、修改 autoload 配置或 CI 中未加载 dev 类等场景才需执行；-o 生成 classmap 提升性能但有局限，配置错误或路径不匹配仍会导致 Class not found。
直接说结论：composer dump-autoload 不是“刷新缓存”，而是重写自动加载映射文件；改了类路径、命名空间或 composer.json 里的 autoload 配置后，必须执行它，否则新类永远找不到。
什么时候非跑 dump-autoload 不行
不是每次改完 PHP 文件都要跑——只有以下情况才真需要：
- 新增了一个类文件（比如
src/Services/Logger.php），但new Logger()报Class not found - 把类从
src/Models/User.php移到了src/Domain/User.php，但命名空间没同步改，或改了但没更新映射 - 在
composer.json的autoload.psr-4里加了新映射（如"App\Domain\": "src/Domain/"） - CI 流水线里用了
composer install --no-dev，但本地开发时写了测试类在autoload-dev下，部署后发现类缺失 -
composer install或update没触发自动重建（比如用了--no-autoloader）
dump-autoload -o 到底优化了什么
-o（即 --optimize）会生成 vendor/composer/autoload_classmap.php，把所有 PSR-4/PSR-0 声明路径下的类文件路径硬编码进一张表里。运行时不再遍历目录、不靠文件名猜类名，直接查表——快，但代价明确：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 只扫描
composer.json里autoload（不含autoload-dev）声明的路径，files类型的函数文件不会被收录 - 新增类文件后，必须再跑一次
dump-autoload -o，否则查不到 - 如果类文件存在但命名错误（比如
Foo.php里定义了class Bar），-o依然会把它写进 classmap——运行时报错，但错误源头难定位 - 离线可用，只要
vendor/autoload.php存在且路径配置没变
为什么跑了 dump-autoload 还是 Class not found
命令执行成功 ≠ 自动加载就通了。真正卡住的地方往往在配置本身：
-
composer.json里"App\": "src/App"少了个末尾/→ 应该是"App\": "src/App/" - 命名空间是
AppControllers，但文件放在src/controllers/HomeController.php（小写controllers）→ Linux 下直接失败 - 用了
"files": ["src/helpers.php"]，但这个文件里定义了class Helper→files只载函数，不注册类 - 执行后检查
vendor/composer/autoload_psr4.php，确认你的命名空间键是否真实存在（比如有没有多打空格、反斜杠转义不对）
生产环境和本地开发的参数差异
别图省事全环境用同一套命令。关键区别在加载范围和容错性：
- 生产部署常用：
composer dump-autoload -o --no-dev --classmap-authoritative→ 关闭 dev 类、启用 classmap 全覆盖、禁止 fallback 查找，性能最高，但漏一个类就 500 - 本地开发慎用
--classmap-authoritative：新增测试类或临时脚本后，不重新 dump 就直接炸 - CI 构建中如果分步执行（先
install --no-dev，再合入 dev 依赖），必须补一句composer dump-autoload --no-dev，否则 autoload 不含 dev 类 - 验证是否生效，别只看命令输出，直接跑：
php -r "require 'vendor/autoload.php'; var_dump(class_exists('AppServicesPaymentService'));"
最容易被忽略的一点：dump-autoload 不校验类定义是否合法，只管路径是否存在、是否匹配配置。上线前务必在目标环境（尤其是大小写敏感的系统）里实测 new 出来几个关键类，而不是只信命令返回的 “Generated autoload files”。
