使用NodeJS在文件指定位置插入文本且不覆盖已有字符的实现方法

直接使用偏移量写入原文件会覆盖对应位置的字节（包括空行的\n换行符），推荐根据文件体积选择以下两种实现方案：

方案1：小文件场景（全量读写，实现简单稳定性高） #

适合体积低于100MB的文件，直接读取全量内容插入目标文本后回写即可：

• 按已知字节偏移量插入的实现：

const fs = require('fs/promises');

async function insertByByteOffset(filePath, emptyLineOffset, insertText) {
  // 读取文件为Buffer避免多字节字符编码偏移错误
  const originBuffer = await fs.readFile(filePath);
  // 拼接新内容：空行前内容 + 插入文本 + 换行符 + 空行后内容
  const newBuffer = Buffer.concat([
    originBuffer.slice(0, emptyLineOffset),
    Buffer.from(`${insertText}\n`),
    originBuffer.slice(emptyLineOffset + 1) // 跳过原空行的\n字符
  ]);
  await fs.writeFile(filePath, newBuffer);
}

• 按已知行号插入的实现：

const fs = require('fs/promises');

async function insertByLineNumber(filePath, targetLineIndex, insertText) {
  const content = await fs.readFile(filePath, 'utf8');
  const lines = content.split('\n');
  // 替换目标空行的内容，原有换行结构不会被破坏
  lines[targetLineIndex] = insertText;
  await fs.writeFile(filePath, lines.join('\n'));
}

方案2：大文件场景（流式处理，低内存占用） #

适合GB级别的大文件，逐行读取写入临时文件后替换原文件即可：

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

async function insertToLargeFile(sourcePath, targetLineIndex, insertText, tempPath = './temp_buffer.tmp') {
  const rl = readline.createInterface({
    input: fs.createReadStream(sourcePath),
    crlfDelay: Infinity
  });
  const writeStream = fs.createWriteStream(tempPath);
  let currentLine = 0;

  for await (const line of rl) {
    if (currentLine === targetLineIndex) {
      writeStream.write(insertText + '\n');
    } else {
      writeStream.write(line + '\n');
    }
    currentLine++;
  }

  writeStream.on('finish', () => {
    // 临时文件写入完成后替换原文件
    fs.renameSync(tempPath, sourcePath);
  });
  writeStream.end();
}

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