Node.js中fs.writeFile执行顺序IO还是随机IO？

一、入门级API（如fs.writeFile）的底层IO类型 #

你提到的fs.writeFile（以及对应的fs.readFile）这类入门教程常用的API，底层默认执行的是顺序IO，原因如下：

• 这类API的设计是一次性读写完整内容：比如你给出的示例代码中，fs.writeFile会直接将content的字节从文件起始位置（文件不存在则创建，存在则覆盖）连续写入，整个过程没有跳过任何字节位置，完全符合顺序IO的定义——按文件指针的连续位置进行读写。
• Node.js的fs模块底层调用的是操作系统原生文件API（比如Linux的write、Windows的WriteFile），这些系统API默认的操作模式就是顺序读写，除非显式指定偏移量。

额外补充：如果用fs.writeFile时指定flags: 'a'（追加模式），本质还是顺序IO——只是写入位置从文件开头变成了文件末尾，依然是连续写入，没有随机跳转。

二、能否手动选择IO类型？ #

可以，核心是通过**文件句柄（File Handle）**结合支持偏移量参数的底层API实现，而非fs.writeFile这类高层封装：

• 要实现随机IO，你需要先通过fs.open()（或fs.promises.open()）获取文件句柄，然后使用fs.write()/fs.read()（或Promise版本）时指定position参数，这个参数就是文件指针的偏移位置，通过设置它可以跳转到文件任意位置读写，实现随机IO。
• 举个随机写入的示例：

const fs = require('fs');

// 打开文件获取句柄
fs.open('/Users/joe/test.txt', 'r+', (err, fd) => {
  if (err) throw err;
  const content = 'Updated!';
  // 从文件第5个字节的位置开始写入（position=4，下标从0开始）
  fs.write(fd, content, 0, 'utf8', 4, (err, bytesWritten) => {
    if (err) throw err;
    console.log(`写入了${bytesWritten}字节`);
    fs.close(fd, (err) => {
      if (err) throw err;
    });
  });
});

简单总结：

• 高层API（fs.writeFile/fs.readFile）：封装了打开、读写、关闭的全流程，只能做顺序IO，适合简单的一次性文件操作。
• 底层句柄API（fs.open+fs.write/fs.read）：支持指定偏移量，能手动控制是顺序还是随机IO，适合需要精细操作文件位置的场景。

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