使用Node.js fs.writeFile写入文件不生效，手动Ctrl+S保存才可用如何解决

1. 修复异步时序逻辑 #

fs.writeFile是异步方法，只有回调函数触发时才代表文件写入完成。如果读取文件的逻辑在调用fs.writeFile之后同步执行，或是在回调触发前执行，此时文件还未完成写入，会出现读取失败的问题。
所有需要操作该文件的后续逻辑必须放在回调内部执行，参考修改代码：

const path = require('path');
// 拼接路径优先使用path.join，避免跨系统路径分隔符异常
const targetPath = path.join(yourDirPath, `${files.length + 1}.json`);
// 确保写入内容是合法JSON字符串，如果json是JS对象必须先序列化
const writeContent = typeof json === 'string' ? json : JSON.stringify(json, null, 2);

fs.writeFile(targetPath, writeContent, "utf8", function (err) {
  if (err) {
    return console.log("写入失败：", err);
  }
  console.log("写入完成");
  // 此处放置读取文件、返回响应等后续逻辑
});

2. 修正路径拼接方式 #

不要使用字符串concat拼接路径，不同操作系统的路径分隔符存在差异，容易出现非法路径导致写入异常。请统一使用Node.js内置path模块的join方法处理路径拼接。

3. 排查写入内容合法性 #

如果传入fs.writeFile的json参数是JS对象而非序列化后的字符串，方法会自动将其转为[object Object]写入文件，生成非法JSON内容，导致应用解析失败误以为文件无有效内容。写入前必须手动序列化JS对象为JSON字符串。

4. 修复文件监听误判问题 #

如果你通过fs.watch、chokidar等工具监听目录变化触发文件读取，写入过程会先创建空文件再写入内容，会触发多次监听事件，首次事件触发时文件还未写完，读取会得到空内容或损坏内容。
修复方式：监听事件触发后延迟300~500ms再读取，或是使用chokidar的awaitWriteFinish配置，等待文件写入完成后再触发读取逻辑。

5. 解决并发写入竞态问题 #

你当前的文件名基于之前读取目录得到的files.length生成，如果短时间内有多个并发请求，多个写入逻辑会拿到相同的files.length值，写入同一个文件导致内容覆盖、损坏，读取自然失败。
修复方式：可以使用UUID、时间戳加随机数作为文件名，或是加锁控制写入逻辑的并发。

6. 极端场景强制刷盘 #

如果确认是操作系统页缓存导致内容没有持久化到磁盘，可以通过文件描述符写入后调用fs.fsync强制刷盘，普通业务场景不需要该操作，仅在对持久化要求极高的场景使用。

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