composer 不会自动清理废弃的 autoload 配置，dump-autoload 仅按 composer.json 照单生成映射，不校验路径是否存在，导致 classmap 残留已删文件、psr-4 留空前缀等隐患。
Composer 不会自动修剪废弃的文件引用 —— 它只按 composer.json 中当前声明的 autoload 配置生成映射，不会扫描或清理已删除但仍在 autoload 配置中残留的路径、命名空间或类名。
为什么 composer dump-autoload 不报错也不警告废弃路径
Composer 的 dump-autoload 命令本质是“照单生成”，不是“智能校验”。它只做三件事：读取配置 → 构建映射表 → 写入 vendor/composer/ 下的 PHP 文件（如 autoload_psr4.php、autoload_classmap.php）。只要配置语法合法，哪怕 "src/old-module/" 目录早已被 rm -rf，它仍会把该路径写进 classmap 或保留空的 PSR-4 前缀条目。
常见错误现象包括：
- 运行时出现
Class "AppOldService" not found，但你确定删了这个类和目录 -
composer dump-autoload -o后性能没提升，甚至变慢——因为 classmap 里还存着几百个已不存在的文件路径 - CI 环境构建失败，提示
file_get_contents(/path/to/missing.php): failed to open stream，源头是 classmap 中残留的已删文件
classmap 类型最危险：它会缓存已删除的文件路径
PSR-4 是按需解析、运行时匹配，出错只在真正用到某个类时；而 classmap 是预生成静态表，一旦生成，就固化了“类名 → 文件路径”的一对一映射。如果之后删了 utils/Helper.php，但 composer.json 里还留着 "classmap": ["utils/"]，那么 dump-autoload 会继续扫描 utils/ 目录——并静默跳过缺失文件，但不会从最终的 autoload_classmap.php 中移除旧记录。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 删完类文件后，**必须手动检查并清理
composer.json中对应的classmap条目**，例如删掉"utils/"或具体文件"utils/Helper.php" - 执行
composer dump-autoload --no-cache（强制忽略旧缓存） +-v查看扫描日志，确认是否还在尝试读取已删路径 - 对 classmap 路径启用 CI 检查：用
find utils/ -name "*.php" | wc -l和grep -c "utils/" vendor/composer/autoload_classmap.php做数量比对
PSR-4 映射前缀残留导致“空命名空间”加载失败
比如你曾配置过 "App\Legacy\": "src/legacy/"，后来整个 src/legacy/ 目录被移除，但忘记删这行配置。此时 Composer 仍会在 autoload_psr4.php 中保留该映射，只是对应值为空数组。问题在于：某些框架或测试工具（如 PHPUnit 的 --bootstrap）在初始化时会遍历所有 PSR-4 前缀，遇到空路径可能抛出 Warning: Invalid argument supplied for foreach() 或直接 crash。
容易踩的坑：
- 用
composer config --unset autoload.psr-4."App\Legacy\"删除配置项，注意转义双反斜杠 - 不要依赖 IDE 自动补全去删
composer.json—— 手动编辑后务必运行composer validate校验 JSON 结构 - PSR-4 前缀末尾的反斜杠
必须存在且严格匹配，"AppLegacy"（少一个）会导致映射失效却不报错
最常被忽略的一点：Composer 从不主动清理 vendor/composer/autoload_*.php 中的历史残余内容。每次 dump-autoload 都是覆盖重写，但“覆盖”不等于“精确擦除”——旧映射若未从配置中显式移除，就会被原样带入新文件。这意味着，autoload 文件的干净程度，完全取决于你对 composer.json 的维护粒度。
