Node.js中fs模块异步写入文件顺序异常问题及方案问询

你遇到的问题核心是fs.writeFile、fs.appendFile都属于异步非阻塞IO方法，和闭包无关：

• 异步方法调用后不会阻塞后续代码执行，仅会将回调函数注册到事件循环，等到IO操作完成后才会执行回调
• 你的代码执行顺序是：同步调用fs.writeFile→同步执行for循环注册100个fs.appendFile回调→同步调用最后追加闭合符的fs.appendFile，所有IO操作的回调执行顺序完全由操作系统调度决定，没有先后保证，因此会出现闭合符先写入、数组元素后写入的顺序混乱问题，并发写入同一个文件本身也会导致内容错乱。

最优方案是先拼接完整的文件内容，再一次性写入文件，仅触发一次IO操作，性能远高于多次追加写入：

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

async function generateOutputFile() {
  // 拼接所有数组元素
  const arrItems = [];
  for (let i = 0; i < 100; i++) {
    // 此处替换为实际的元素生成逻辑，例如：arrItems.push(JSON.stringify(latlon_datum1_row[i]))
    arrItems.push('HI');
  }
  // 拼接完整的文件内容
  const fileContent = `export const addressPoints = [
${arrItems.join(',\n')}
];`;
  // 一次性写入文件
  await fs.writeFile('Output.js', fileContent);
  console.log('文件生成完成');
}

generateOutputFile().catch(err => {
  throw err;
});

如果确实需要逐次写入（比如待写入内容体积过大无法一次性放入内存），可以通过async/await保证异步操作按顺序执行：

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

async function generateOutputFile() {
  // 写入数组头部
  await fs.writeFile('Output.js', 'export const addressPoints = [');
  console.log('Create file Output.js');
  
  // 按顺序写入数组元素
  for (let i = 0; i < 100; i++) {
    const stringRow = 'HI';
    await fs.appendFile('Output.js', stringRow);
    console.log('Writing file contents line', i);
  }

  // 写入数组闭合符
  await fs.appendFile('Output.js', '];');
  console.log('Append file Output.js');
}

generateOutputFile().catch(err => {
  throw err;
});

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