近日，前端构建工具 Webpack 的一个长期存在的“小问题”再次引发开发者社区的讨论：当使用 stats: 'error-only' 配置并开启 watch 模式后，一旦代码中的错误被修复，终端窗口并不会自动清除之前的错误输出，导致开发者不得不手动清屏或等待下一次触发才能确认错误是否已消失。这一行为虽不致命，却在持续集成与本地开发流程中造成了不必要的认知负担，尤其对于追求高效反馈循环的团队而言，体验差强人意。

问题描述：修复后“残留”的错误信息

Webpack 的 stats 配置项用于控制构建信息的输出详细程度，其中 'error-only' 模式旨在仅显示错误与警告，减少无关日志。在 watch（监听）模式下，文件变更时会自动重新编译。正常情况下，一旦错误被修复，新的编译状态应覆盖旧的输出。然而，大量开发者反馈，当设置为 error-only 时，修复错误后终端中的红色错误信息依然保留，只有再次触发编译（例如保存其他文件）或手动输入 clear 命令才能刷新界面。

这一现象在 Webpack 4 及 5 的多个版本中均被观察，且并非偶然的渲染 bug，而是与 Webpack 内部输出缓冲区刷新逻辑相关。在默认 'normal' 或 'minimal' 模式下，Webpack 会清除上一轮输出并重新写入，但 'error-only' 模式下，由于设计上只输出错误，Webpack 在无错误时不产生任何输出，因此也“想不起”需要清理终端中之前的错误文本。本质上，这是一个状态管理的疏忽：输出层没有区分“本周期有错误”和“本周期无错误但需清空上一周期错误”两种情境。

影响范围：从个人开发到 CI 流水线

对于日常使用 error-only 的开发者，这个问题的直接影响是：当看到红色错误时，必须手动判断是新的错误还是旧的残留。在快速迭代过程中，修复一个错误后下意识地希望终端立刻变“干净”，但现实却是错误信息顽固地停留在屏幕上，容易造成误判——开发者可能认为错误依然存在，进而浪费时间反复检查已修复的代码。

在团队协作和 CI（持续集成）场景中，影响则更为明显。许多 CI 脚本通过捕获 Webpack 输出判断构建状态，若输出未正确清空，可能解析到上一轮的旧错误，导致流水线误判为失败。虽然严格的错误处理通常依赖 exit code，但日志清晰度对调试效率至关重要。此外，若配合 webpack-dev-server 的热更新（HMR）使用，该问题同样存在，因为 HMR 内部也依赖相同的 stats 输出逻辑。

社区反馈：期待已久的修复

该问题在 Webpack GitHub 仓库中已有多条 issue 讨论（如 #13791、#15086 等），最早可追溯至 2019 年。部分开发者尝试通过自定义 infrastructureLogging 或使用第三方 npm 包（如 webpack-clear-terminal）来规避，但这些方案要么引入额外依赖，要么在复杂配置中存在兼容性问题。

Webpack 核心维护者 Tobias Koppers 曾回应称，该行为源于 stats 模块的设计取舍，真正的修复需要对输出渲染器进行重写，涉及较大改动。目前 Webpack 主线版本虽已对新版 Node.js 和现代语言特性做出大量优化，但此类“非功能性”的小问题优先级往往较低。社区中有声音建议：当 stats: 'error-only' 且 watch 模式下检测到错误从有到无时，至少应输出一个空行或清屏指令，以提示开发者编译已完全通过。

解决方案探索：workaround 与未来展望

对于急于解决此问题的开发者，目前最可靠的 workaround 是使用 'errors-warnings' 或 'minimal' 模式替代 'error-only'，虽然会增加少量日志，但能确保终端正确刷新。另一个方案是在 Webpack 配置文件中通过 infrastructureLogging 设置 appendOnly: false，强制每次编译覆盖输出，但可能影响缓存效率。还有开发者利用终端 ANSI 转义序列，写一个简单的自定义插件，在 done 钩子中清屏。

长远来看，Webpack 5 生命周期已趋于稳定，团队正将更多精力投入下一代构建工具（如 Turbopack）。不过，Webpack 作为生态中应用最广泛的打包工具，此类基础体验问题依然值得优先解决。有社区成员甚至发起 PR 尝试修复，但因需要兼顾所有 stats 级别和终端兼容性，审核进度缓慢。

结语

从技术角度看，error-only 清空问题或许只是 Webpack 数千个 issue 中的一个“小 case”，但它在日常开发中的触发频率几乎与每个代码保存动作相关，直接影响到开发者的即时反馈感受。在持续集成与快速迭代成为主流的今天，构建工具的“用户体验”已不仅仅关乎性能，更关乎输出信息的准确性与及时性。或许，Webpack 团队在推进下一代工具的同时，也不应忽视对现有版本这类“磨人”细节的打磨——毕竟，为开发者省去每一次不必要的“clear”命令，也是提高效率的扎实一步。