process.stdout.write在pm2 log中偶现换行？如何保证原子输出？

问题根源 #

pm2的pm2 log实时查看功能，是通过捕获进程stdout的data事件来获取输出的——每调用一次process.stdout.write，就会触发一次data事件。pm2对每个事件的内容会单独处理，在终端显示时可能将其拆分为不同行；但日志文件是直接追加整个输出流，所以不会出现拆分问题。当两次write之间加入延迟，两个data事件的间隔被拉长，pm2会更明确地将它们视为独立输出块，导致内容永久分属两行。

解决方法 #

要实现原子输出，确保连续write的内容直到遇到换行才被拆分，有两种直接的处理方式：

• 合并内容后单次写入
  把需要连续输出的内容拼接成一个字符串，只用一次process.stdout.write输出，这样pm2只会捕获到一次data事件，不会拆分内容：

  while(true) {
    // 合并XY为单次输出
    process.stdout.write("XY");
    console.log("");
    await new Promise(resolve => setTimeout(resolve, 1000));
  }
  

• 手动缓冲输出内容
  封装一个缓冲函数，将零散的输出内容暂存，直到遇到换行符或主动触发时，再一次性写入stdout，确保内容作为一个整体被pm2捕获：

  let outputBuffer = '';
  
  function bufferedWrite(str) {
    outputBuffer += str;
    // 检测到换行时，一次性输出缓冲内容
    if (outputBuffer.includes('\n')) {
      process.stdout.write(outputBuffer);
      outputBuffer = '';
    }
  }
  
  while(true) {
    bufferedWrite("X");
    bufferedWrite("Y");
    // 写入换行触发缓冲输出
    bufferedWrite("\n");
    await new Promise(resolve => setTimeout(resolve, 1000));
  }
  

内容的提问来源于stack exchange，提问作者Nabi K.A.Z.