Node.js中如何高效替换JSON数组内单个对象的指定属性？

问题背景 #

我搜索了大量关于解析JSON数组的在线文章，也尝试寻找相关npm包，但都没有成功。我有一个如下所示的JSON数组：

{ 
  "pctProjects": [ 
    { 
      "ID": "1", 
      "Name": "Software Upgrade", 
      "Desc": "GO! V1 Chapter 5- EOC Mastery Exercise", 
      "AppId": "1", 
      "UserId": "1", 
      "CreatedDate": "2008-07-30T00:00:00", 
      "Score": "100", 
      "SeriesID": "2", 
      "IsPublished": "1", 
      "PublishedLMSVariationID": "5", 
      "IsPCTActive": "0", 
      "IVTEnabled": "0", 
      "IsActiveInSelectPopup": "1", 
      "Chapter": "CH05" 
    }, 
    { 
      "ID": "2", 
      "Name": "Business Venture", 
      "Desc": "Exploring Volume 1 Chapter 3- TST Exercise", 
      "AppId": "1", 
      "UserId": "1", 
      "CreatedDate": "2008-07-30T00:00:00", 
      "Score": "100", 
      "SeriesID": "1", 
      "IsPublished": "1", 
      "PublishedLMSVariationID": "7", 
      "IsPCTActive": "0", 
      "IVTEnabled": "0", 
      "IsActiveInSelectPopup": "1", 
      "Chapter": "CH03" 
    }
    // ... 更多对象
  ]
}

我通过JSON.parse方法遍历pctProjects数组，能够通过PublishedLMSVariationID找到需要修改属性值的对象，目前使用fs模块的appendFileSync()和writeFileSync()方法更新文件，但这种方法需要重写所有未修改的对象数据，在数组包含大量对象时并不高效。同时，使用replace-in-file也未能实现目标。以下是我当前使用的非最优代码片段：

for(let item of gulpJson.pctProjects){ 
  // console.log(typeof touseVariationId) 
  if(counter==1 && item.PublishedLMSVariationID == results[0]){ 
    item.PublishedLMSVariationID = results[1] 
    fs.writeFileSync(path.join(dir,'PCT5_MasterPCTProjectsForGulp.json'), JSON.stringify(item,null,4)); 
    counter++; 
  } else if(counter==1 && item.PublishedLMSVariationID != results[0]){ 
    fs.writeFileSync(path.join(dir,'PCT5_MasterPCTProjectsForGulp.json'), JSON.stringify(item,null,4)); 
    counter++; 
  } else if(item.PublishedLMSVariationID == results[0]){ 
    item.PublishedLMSVariationID = results[1] 
    fs.appendFileSync(path.join(dir,'PCT5_MasterPCTProjectsForGulp.json'), JSON.stringify(item,null, 4)); 
    // break 
    // fs.writeFileSync(path.join(dir,'PCT5_MasterPCTProjectsForGulp.json',null, 2), JSON.stringify(item)); 
  } else fs.appendFileSync(path.join(dir,'PCT5_MasterPCTProjectsForGulp.json'),","+"\n"+"\t"+ JSON.stringify(item,null, 4)); 
}

问题： 在Node.js中是否存在仅替换JSON数组内单个对象指定属性的高效方法？

回答 #

当然有更高效的方法！你当前的问题在于逐行写入/追加文件，这不仅容易导致JSON格式错误（比如手动加逗号的操作很容易出错），而且每次IO操作都有性能开销，尤其是数据量大的时候。

正确的高效思路应该是：

• 一次性读取整个JSON文件到内存中
• 在内存中找到目标对象并修改对应的属性
• 一次性将整个修改后的JSON写回文件

这种方法只需要两次IO操作（读+写），相比你之前的多次写入/追加要高效得多，而且能保证JSON格式的正确性。

下面是优化后的代码示例：

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

// 1. 读取文件并解析为JSON对象
const filePath = path.join(dir, 'PCT5_MasterPCTProjectsForGulp.json');
const gulpJson = JSON.parse(fs.readFileSync(filePath, 'utf8'));

// 2. 在内存中找到目标对象并修改属性
const targetId = results[0];
const newVariationId = results[1];
const targetItem = gulpJson.pctProjects.find(item => item.PublishedLMSVariationID === targetId);

if (targetItem) {
  targetItem.PublishedLMSVariationID = newVariationId;
  
  // 3. 一次性写回整个JSON文件
  fs.writeFileSync(filePath, JSON.stringify(gulpJson, null, 4));
  console.log('属性修改成功！');
} else {
  console.log('未找到匹配的对象');
}

为什么这个方法更高效？ #

• 减少IO操作：从多次文件写入/追加变成仅一次读和一次写，IO操作是Node.js中相对耗时的操作，减少次数能大幅提升性能
• 避免格式错误：直接使用JSON.stringify处理整个对象，不会出现手动拼接逗号导致的JSON语法错误
• 代码更简洁易维护：逻辑清晰，不需要维护counter这类状态变量

如果你的JSON文件特别大（比如几百MB甚至GB级），一次性读取到内存可能会有问题，这时候可以考虑使用流式JSON解析器（比如JSONStream包），但对于大多数常规大小的JSON文件，上面的方法完全够用且高效。

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