Node.js文件读取：同步与异步实现详解

作者：栖木

时间：2026-10-21

本文介绍Node.js中读取文件内容的两种主要方式：同步与异步。通过对比fs.readFileSync和fs.readFile的使用场景及执行结果，解析Node.js异步I/O基于回调函数和事件循环的工作原理，帮助开发者理解阻塞与非阻塞操作的区别。

文章目录

Node.js文件读取概述

在Node.js环境中，读取文件内容主要提供同步和异步两种实现路径。

同步读取实现

第一种方式是同步读取，核心方法为readFileSync。


var rf=require("fs"); 
var data=rf.readFileSync("test","utf-8"); 
console.log(data); 
console.log("READ FILE SYNC END");

同步执行的输出顺序表现为：先打印文件内容，随后打印结束标识。

Node.js文件读取概述

异步读取机制

第二种方式是异步读取，对应的方法为readFile。


var rf=require("fs"); 
rf.readFile("test",'utf-8',function(err,data){ 
  if(err){ 
    console.log("error"); 
  }else{ 
    console.log(data); 
  } 
}); 
console.log("READ FILE ASYNC END");

异步执行的输出顺序表现为：先打印结束标识，随后打印文件内容。

Node.js文件读取概述

同步读取文件的逻辑直观易懂。将文件名作为参数传入fs.readFileSync函数后，程序会阻塞当前线程，直到文件读取完成。此时，文件内容作为函数的返回值被赋给data变量，接着控制台输出data的值，最后输出end。

异步读取的执行顺序可能初看有些反直觉，即end先于内容输出。要理解这一现象，需明确Node.js中异步I/O依赖回调函数机制。fs.readFile方法接收三个参数：文件名、编码格式以及一个回调函数。

JavaScript支持匿名函数定义，例如在fs.readFile的参数表中直接嵌套定义回调函数。此外，也可以将上述异步读取中的回调函数提取为独立函数以便复用。


var rf=require("fs"); 
function callBack(err,data){ 
  if(err){ 
    console.log("error"); 
  }else{ 
    console.log(data); 
  } 
} 
rf.readFile("test","utf-8",callBack); 
console.log("READ FILE ASYNC END");