使用转换流按行处理文本时，若文件末尾无换行符，最后一行会滞留缓冲区导致“假死”；必须实现 _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()，它会自动传播错误并清理资源
