使用转换流按行处理文本时，若文件末尾无换行符，最后一行会滞留缓冲区导致“假死”；必须实现 _flush 方法主动推送剩余数据，或改用 split2 等可靠分块器。

在使用转换流（如 Node.js 的 Transform 流）处理文本文件时，若文件末尾没有换行符（\n），而你的逻辑又依赖“按行处理”（例如用 split2、byline 或手动累积缓冲区等待换行），就容易在最后一行卡住——流不结束、数据不吐出，看起来像“假死”。这不是流本身故障，而是处理逻辑未覆盖边界情况。

确保最后一块数据被主动 flush

很多基于换行的解析器（比如自定义的 Transform）只在遇到 \n 时才输出当前行。如果最后一行没换行，它就一直缓存在内部 buffer 里，且流已结束（'end' 事件触发），但你没在 flush 钩子中清空它。

• 如果你继承 Transform 并重写了 _transform，务必实现 _flush 方法
• 在 _flush 中检查是否有未提交的剩余内容（如 this._buffer 不为空），如果有，调用 callback(null, this._buffer) 或 this.push(this._buffer)
• 示例：this.push(this.remainder); callback();

用可靠分块器替代手写换行逻辑

手动处理换行易出错，尤其面对 \r\n、\r、UTF-8 多字节字符跨 chunk 等情况。优先使用成熟分块流：

• split2：默认以 \n 分割，且会在流结束时自动 push 剩余内容（v3+ 版本已修复末尾无换行问题）
• through2 + split2 组合：比裸写 Transform 更安全
• 避免用 readline 模块搭配流——它内部有缓冲和异步机制，在管道中易导致背压或挂起

校验输入源是否规范（可选但实用）

开发阶段可加一层轻量检查，提前发现不规范文件：

• 读取文件最后几个字节（如用 fs.createReadStream 配 start/end 选项），判断末尾是否为 \n、\r\n
• 非强制修复，但可打印 warning，提醒“该文件末尾无换行，可能影响流式解析”
• CI 或脚本中可用 file --mime-encoding + tail -c1 快速检测

设置超时与可观察性（防真死）

即使逻辑正确，网络流或异常中断也可能让流迟迟不结束。加一层兜底：

• 对关键流操作封装 Promise.race，配合 setTimeout 抛错
• 监听 'close'、'error'、'end'，并在 _flush 中打日志，确认是否执行
• 用 stream.pipeline 替代手动 .pipe()，它会自动传播错误并清理资源