Node.js中fs.appendFile写入CSV文件未换行追加内容问题求解

• 换行符兼容问题：老版本Windows记事本仅支持CRLF（\r\n）作为换行标识，若你的代码运行环境为Linux/macOS，手动硬编码的\r\n可能存在隐式转换，或是之前某次程序运行异常，仅写入了记录内容未写入末尾的换行符，后续追加的内容就会直接拼接在原有内容末尾，记事本就会显示为连续的一行。
• 手动编辑后恢复正常的原因：Windows记事本编辑保存文件时，会自动为末尾没有换行符的文件补全CRLF换行，因此后续程序追加的内容就会从新行开始，显示自然恢复正常。

方案1：使用系统适配的换行符 #

引入Node.js内置os模块的EOL常量，自动适配当前系统的换行符，避免硬编码带来的兼容问题：

const fs = require('fs');
const os = require('os');

fs.appendFile(`data/battle-log.csv`, `${new Date().toLocaleString()},1,0,0${os.EOL}`, 'utf8', function (err) {
    if (err) {
       console.log(err);
    }
});

方案2：追加前主动补全前置换行 #

如果需要确保无论原有文件状态如何，新记录一定单独占行，可以在追加前判断文件末尾是否已有换行符，不存在就先补一个：

const fs = require('fs');
const os = require('os');
const logPath = 'data/battle-log.csv';

fs.access(logPath, fs.constants.F_OK, (accessErr) => {
  let leadingEOL = '';
  // 文件存在时检查末尾字符
  if (!accessErr) {
    const fileStats = fs.statSync(logPath);
    if (fileStats.size > 0) {
      const readBuffer = Buffer.alloc(1);
      const fileDescriptor = fs.openSync(logPath, 'r');
      fs.readSync(fileDescriptor, readBuffer, 0, 1, fileStats.size - 1);
      fs.closeSync(fileDescriptor);
      const lastChar = readBuffer.toString('utf8');
      // 末尾不是换行符就补前置换行
      if (lastChar !== '\n' && lastChar !== '\r') {
        leadingEOL = os.EOL;
      }
    }
  }
  // 写入内容，包含前置换行和末尾换行
  fs.appendFile(logPath, `${leadingEOL}${new Date().toLocaleString()},1,0,0${os.EOL}`, 'utf8', (writeErr) => {
    if (writeErr) console.log(writeErr);
  });
});

额外优化建议 #

日常查看CSV文件优先使用VS Code、Notepad++等第三方文本编辑器，这类工具对不同系统的换行符兼容性更强，不会出现换行显示异常的问题。

内容的提问来源于stack exchange，提问作者koyamashinji