composer dump-autoload 无法局部刷新包的 autoload 映射，它总是全量扫描并重写所有映射文件；真正影响单个包 autoload 的操作只有 composer update 或 composer require。
composer dump-autoload 不能局部刷新包的 autoload 映射
直接说结论：composer dump-autoload 没有“只刷某个包”的能力。它读取整个 composer.json 的 autoload 和 autoload-dev 配置，扫描所有声明路径下的 PHP 文件，一次性重写全部映射文件（如 vendor/composer/autoload_psr4.php）。你无法指定 “只处理 monolog/monolog 的类路径” 或 “跳过 tests/ 目录”。
为什么想“局部刷新”通常是误解了问题根源
当你发现某个依赖包里的类突然 Class not found，第一反应不该是 dump-autoload，而应确认：这个包本身的 autoload 声明是否已更新？
- 如果该包升级了（比如从 v2.8 → v2.10），且新版改了
psr-4路径（如"Monolog\": "src/"→"Monolog\": "lib/"），那么仅运行composer dump-autoload是无效的——它仍按旧版installed.json中记录的路径去扫描，根本找不到新位置的类 - 正确做法是先
composer update monolog/monolog（拉取新版包并更新vendor/和installed.json），再补一次composer dump-autoload（让 autoloader 读到新版路径） - 如果你只是改了自己项目里的类（比如新增
AppServicesReportGenerator），那composer dump-autoload确实管用，但它刷新的是你项目配置的路径，和monolog/monolog无关
真正能“影响单个包 autoload 行为”的操作只有两种
它们都不靠 dump-autoload，而是靠 Composer 自身机制：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer update vendor/package-name：会更新该包及其必要子依赖，并自动触发一次完整的dump-autoload（含该包的新 autoload 声明） -
composer require vendor/package-name：安装新包时，Composer 会读取其composer.json中的 autoload 配置，并纳入下次dump-autoload的扫描范围
注意：composer install 或 composer update（无参数）也会触发 autoload 重建，但它是全量的，且附带依赖重算——这不是“局部”，只是顺带做了 autoload 刷新。
容易被忽略的兼容性细节
即使你成功让某个包的 autoload 生效，也得留意这些硬性限制：
- PSR-4 映射路径区分大小写，Linux/CI 环境下
"App": "src/"和"App": "SRC/"完全不同，dump-autoload不会报错，但类加载必失败 - 加
-o参数生成 classmap 后，所有类路径被固化为静态数组；此时你新增一个类文件，不重新dump-autoload就永远进不了映射表 -
files类型的全局函数（如"files": ["src/helpers.php"]）在加-o后会被静默跳过——这类文件必须靠标准 PSR-4 或手动require
所谓“局部刷新”，本质是厘清改动发生在哪一层：是你自己的代码结构？还是依赖包的版本与 autoload 声明？搞错这一层，dump-autoload 就成了无用功。
