Node.js 实现仅当文本文件不存在目标行时才执行fs.appendFile追加写入

你最初想到的「全量读文件→拆分行数组→判断目标内容是否存在→不存在再追加」的思路，完全适配这个文件最多200行的场景，是没有性能损耗的最优解，根本不需要上流式读取、文件锁、外部索引这类重型方案。

核心优化点（避开你写代码容易踩的坑） #

• 拆分换行时要兼容Windows下的\r\n格式，不要硬按\n拆分导致匹配失效
• 要判断原文件末尾是否自带换行，避免追加内容和上一行黏连，也不会产生多余空行，解决你原有直接硬拼'\n'+x追加写法的常见边界问题
• 要兼容目标文件第一次不存在的场景，避免直接报文件找不到的错误
• 不需要手写循环遍历数组，用数组原生includes()做精准整行匹配就行，效率和手写遍历无差异，代码更简洁

完整可运行实现（全Node.js内置能力，无第三方依赖） #

const fs = require('fs/promises');
const filePath = './file.txt';
const x = 'Aimee Kestenberg'; // 你的待写入变量

async function appendLineDeduplicated() {
  try {
    // 全量读文件，200行的文本总大小不足2KB，内存/IO开销可以忽略
    const fileContent = await fs.readFile(filePath, 'utf8');
    // 按任意换行格式拆分行，过滤掉拆分产生的空字符串
    const existingLines = fileContent
      .split(/\r?\n/)
      .filter(line => line !== '');

    // 精准判断整行是否已存在
    if (existingLines.includes(x)) {
      console.log('目标内容已存在，跳过写入');
      return;
    }

    // 处理文件末尾无换行的边界情况，避免内容黏连
    const needAddNewline = fileContent.length > 0 && !fileContent.endsWith('\n');
    const appendContent = `${needAddNewline ? '\n' : ''}${x}\n`;
    await fs.appendFile(filePath, appendContent, 'utf8');
    console.log('目标内容不存在，已完成追加');

  } catch (err) {
    // 兼容文件不存在的初始场景
    if (err.code === 'ENOENT') {
      await fs.writeFile(filePath, `${x}\n`, 'utf8');
      return;
    }
    throw err;
  }
}

// 执行逻辑
appendLineDeduplicated();

补充说明 #

这类小文件场景下，逐行流式扫描、读写锁、外部缓存索引的方案都是过度设计：全量读一次2KB文本的耗时在纳秒级别，带来的额外开发和维护成本远高于收益。如果后续存在多任务并发同时写同一个文件的场景，只需要把上述异步函数加一个简单的任务队列，保证同一时间只有一个任务执行读-判断-写的逻辑，就能避免并发下的重复写入问题，完全不需要引入重型的文件操作库。

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