Node.js中如何用文件标志实现JSON文件数据追加？

解决方法 #

1. 参数顺序错误导致flag无效 #

Node.js文件系统API的参数格式是固定的：

• 同步方法fs.writeFileSync(path, data[, options])：第三个参数是包含编码、标志的选项对象，不能拆分传参
• 异步方法fs.writeFile(path, data[, options], callback)：选项对象是第三个参数，回调是第四个
• Promise版本fs.promises.writeFile(path, data[, options])：没有回调参数，用await或.then()处理结果

你错误地把'utf8'和{ flag: 'as+' }拆成两个独立参数，导致选项对象未被识别，默认使用'w'（覆盖）模式，这就是追加失效的核心原因。

修正后的代码示例：

同步版本

const fs = require('fs');

function writeFile(obj) {
  const jsonContent = JSON.stringify(obj, null, 2);
  try {
    // 把编码和标志合并到同一个options对象
    fs.writeFileSync("myData.json", jsonContent, { encoding: 'utf8', flag: 'a+' });
    console.log("File updated.");
  } catch (err) {
    console.log("An error occurred while writing JSON Object to File.");
    console.error(err);
  }
}

异步版本

const fs = require('fs');

function writeFile(obj) {
  const jsonContent = JSON.stringify(obj, null, 2);
  fs.writeFile("myData.json", jsonContent, { encoding: 'utf8', flag: 'a+' }, (err) => {
    if (err) {
      console.log("An error occurred while writing JSON Object to File.");
      return console.error(err);
    }
    console.log("File updated.");
  });
}

Promise版本

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

async function writeFile(obj) {
  const jsonContent = JSON.stringify(obj, null, 2);
  try {
    await fs.writeFile("pagespeed.json", jsonContent, { encoding: 'utf8', flag: 'a+' });
    console.log("File updated.");
  } catch (err) {
    console.log("An error occurred while writing JSON Object to File.");
    console.error(err);
  }
}

2. 直接追加JSON会导致文件格式无效 #

即使修正了参数，用a+直接追加JSON字符串会生成无效JSON（比如{"a":1}{"b":2}），后续无法正常解析。推荐两种可靠方案：

方案A：先读取再合并写入（最稳妥）

读取现有文件内容，解析为JS数组/对象，合并新数据后重新写入：

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

async function appendToJsonFile(obj) {
  const filePath = "myData.json";
  let existingData = [];

  try {
    // 读取现有文件
    const fileContent = await fs.readFile(filePath, 'utf8');
    existingData = JSON.parse(fileContent);
    // 兼容原文件是单个对象的情况，转为数组
    if (!Array.isArray(existingData)) {
      existingData = [existingData];
    }
  } catch (err) {
    // 文件不存在或格式错误时初始化空数组
    if (err.code === 'ENOENT') {
      console.log("File not found, creating new JSON file.");
    } else if (err instanceof SyntaxError) {
      console.log("Existing file has invalid JSON, resetting to empty array.");
    } else {
      throw err;
    }
  }

  // 添加新数据
  existingData.push(obj);
  // 写入合并后的有效JSON
  await fs.writeFile(filePath, JSON.stringify(existingData, null, 2), 'utf8');
  console.log("Data appended successfully.");
}

方案B：维护JSON数组的追加模式（适合超大文件）

如果文件过大无法一次性读取，可维护数组格式：

• 首次写入：fs.writeFileSync(filePath, [${JSON.stringify(obj)}], 'utf8')
• 后续追加：fs.writeFileSync(filePath, ,${JSON.stringify(obj)}, { encoding: 'utf8', flag: 'a+' })
• 最后需手动补全]（或在程序结束时写入）

这种方式需要额外处理文件初始状态，复杂度较高，仅在必要时使用。

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