Node.js 如何向文件追加内容？

Node.js 追加文件用 fs.appendFile（回调）、fs.promises.appendFile（async/await）或 fs.appendFileSync（同步）；大数据量用 fs.createWriteStream 的 flags:'a' 流式追加。本文给出四种写法与适用场景。

观测云编辑部 2026-09-28 3 分钟阅读更新于 2026-09-28

最佳实践

小数据用 fs.appendFile，大数据/持续写入用 fs.createWriteStream 加 { flags: 'a' }。

方式一：fs.appendFile（回调式）

const fs = require('fs');

fs.appendFile('log.txt', '新的一行\n', (err) => {
  if (err) {
    console.error('追加失败:', err);
    return;
  }
  console.log('追加成功');
});

appendFile 和 writeFile 默认都可创建不存在的文件；区别在默认模式：appendFile 追加，writeFile 截断已有文件。

方式二：Promise 版（async/await 推荐）

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

async function main() {
  await fs.appendFile('log.txt', '新的一行\n');
}
main().catch((err) => {
  console.error('追加失败:', err);
  process.exitCode = 1;
});

方式三：同步版（脚本场景）

const fs = require('fs');
fs.appendFileSync('log.txt', '新的一行\n');

同步会阻塞事件循环，只在 CLI 脚本、启动初始化等场景用。

方式四：流式追加（大文件/高频写入）

const fs = require('fs');

const stream = fs.createWriteStream('big.log', { flags: 'a' });  // flags:'a' 表示追加
stream.on('error', (err) => console.error('写入失败:', err));
stream.write('第一块数据\n');
stream.write('第二块数据\n');
stream.end();

流式写入可分块处理；大量持续写入时必须在 write 返回 false 后等待 drain，避免内存缓冲持续增长。finish 表示流写入已交付到底层，不自动保证断电持久性；并非所有大文件场景都必须使用流。

怎么选

场景	方法
偶尔追加几行	`fs.promises.appendFile`
脚本里同步写	`fs.appendFileSync`
高频/大量持续写入	`fs.createWriteStream('log.txt', {flags:'a'})`