Node.js回调函数的基本用法

Node.js 回调函数

在Node.js的世界里，异步编程是它的核心基因，而回调函数就是实现这个基因的最基本方式。简单来说，它就像是在超级市场排队结账——你把自己的“小纸条”（回调函数）交给收银员，然后就可以去干别的事，等轮到你了，收银员自然会把结果喊给你。这种机制让Node.js能够同时处理成千上万个请求，而不会因为某个操作卡住整个流程。那么，回调函数究竟怎么用？又有哪些坑需要避开？下面我们来一层层拆解。

概述

回调函数的核心定义其实很简单：把一段代码作为参数传递给另一个函数，等到该函数执行完它的主要任务后，再回过头来调用这段代码。在Node.js中，最常见的应用场景就是文件读写、网络请求、数据库查询等I/O操作。因为这些操作的具体完成时间不确定，所以不能像同步代码那样顺序执行，必须通过回调来“事后通知”。

回调函数的定义

更精确一点说，回调函数就是那些被传入其他函数中，并在该函数执行完毕后调用的函数。在Node.js里，它们通常以匿名函数的形式出现，并且在异步操作的完成回调中被调用。你写的每一行异步代码，几乎都离不开这个模式。

回调函数的基本用法

来看一个实际例子。下面这个readFile函数模拟了一个文件读取操作，它接受一个回调函数作为参数：

function readFile(callback) {
  // 模拟文件读取操作
  setTimeout(() => {
    callback(null, '文件内容');
  }, 1000);
}

readFile((err, data) => {
  if (err) {
    console.error('读取文件出错:', err);
    return;
  }
  console.log('读取到的文件内容:', data);
});

这里用setTimeout模拟异步操作，1秒后调用传入的回调函数。回调函数接收两个参数：第一个是错误对象（如果没有错误则为null），第二个是读取到的数据。这种“错误优先”的约定是Node.js回调函数的标准风格，用起来非常一致。

回调地狱

如果只是处理一两个异步操作，回调函数看起来还挺清爽。但一旦业务逻辑复杂起来，需要依次读取多个文件、再做一些后处理，代码就会变成让人头疼的“回调地狱”。

什么叫回调地狱？看看下面这个例子就明白了：

function readFile1(callback) {
  setTimeout(() => {
    callback(null, '文件内容1');
  }, 1000);
}

function readFile2(callback) {
  setTimeout(() => {
    callback(null, '文件内容2');
  }, 1000);
}

function readFile3(callback) {
  setTimeout(() => {
    callback(null, '文件内容3');
  }, 1000);
}

readFile1((err, data) => {
  if (err) { console.error('读取文件1出错:', err); return; }
  readFile2((err, data) => {
    if (err) { console.error('读取文件2出错:', err); return; }
    readFile3((err, data) => {
      if (err) { console.error('读取文件3出错:', err); return; }
      console.log('读取到的文件内容:', data);
    });
  });
});

这段代码最大的问题就是嵌套太深——每多一个异步操作，缩进就向右多一层。不仅读起来费劲，修改和调试也很痛苦。而且每个回调里都要重复处理错误判断，看上去像一堆俄罗斯套娃。这正是“回调地狱”的典型特征：代码结构混乱、可读性差、难以维护。

好在Node.js社区很快给出了几种优雅的解决方案，其中最主流的就是Promise和async/await。

Promise

Promise是解决回调地狱的一种更为现代化的编程模式。你可以把它理解成一个“承诺”——异步操作最终要么成功并返回结果，要么失败并返回错误。Promise链式调用的写法，能把原来层层嵌套的结构拍平，逻辑一目了然。

来看用Promise改写刚才的例子：

function readFile1() {
  return new Promise((resolve, reject) => {
    setTimeout(() => { resolve('文件内容1'); }, 1000);
  });
}

function readFile2() {
  return new Promise((resolve, reject) => {
    setTimeout(() => { resolve('文件内容2'); }, 1000);
  });
}

function readFile3() {
  return new Promise((resolve, reject) => {
    setTimeout(() => { resolve('文件内容3'); }, 1000);
  });
}

Promise.all([readFile1(), readFile2(), readFile3()])
  .then((results) => {
    console.log('读取到的文件内容:', results);
  })
  .catch((err) => {
    console.error('读取文件出错:', err);
  });

这里用Promise.all()同时启动三个读取操作，等待所有结果返回后再统一处理。如果某个文件读取失败，catch会立即捕获错误，不会再继续执行后面的逻辑。整个代码平铺直叙，不再有层层嵌套。

async/await

Promise虽然解决了嵌套问题，但.then()链写多了仍然不够直观。于是ES2017带来了async/await语法，它让异步代码写起来就像同步代码一样自然。

继续用同样的例子，看看async/await的写法：

async function readFiles() {
  try {
    const data1 = await readFile1();
    const data2 = await readFile2();
    const data3 = await readFile3();
    console.log('读取到的文件内容:', [data1, data2, data3]);
  } catch (err) {
    console.error('读取文件出错:', err);
  }
}

readFiles();

在async函数内部，每一行await都会暂停函数的执行，直到等待的Promise完成。代码风格和传统的同步代码几乎一样，但底层仍然是异步非阻塞的。错误处理用try/catch包裹，非常清晰。可以说，async/await是目前在Node.js中处理异步操作最推荐的方式。

总结

回调函数是Node.js异步编程的起点，理解它是用好Node.js的必修课。从最基本的回调模式，到回调地狱的痛点，再到Promise和async/await的演进，这条技术路线清晰地展示了社区如何一步步让异步代码变得更可读、更可维护。实际开发中，具体选哪种方式取决于场景：简单的单次异步操作，回调足够；多个异步操作需要并行或顺序组合，用Promise；需要清晰顺序逻辑并且避免嵌套，async/await几乎是最佳选择。掌握它们，你的Node.js编码水平会上一个大台阶。