TapCub 正式上线:统计、分析、客服一个平台免费用
术语表

什么是回调(callback)?含义、同步与异步,以及示例

回调是你交给另一段代码、让它之后再来调用的函数。同步回调和异步回调的区别,让初学者意外的输出顺序,以及一个比较嵌套调用和并行调用耗时的算例。

苏禾 审核人 伊森·布鲁克斯 又称 回调函数 最后更新 2026 年 11 月 19 日 术语表

一句话回答

回调是传给另一段代码的函数,让对方在事件发生或任务完成后再来调用它。它是事件处理和异步代码的基本构件,SDK 的错误和同意钩子也用它。

回调是什么

回调(callback)是你交给另一段代码的一个函数,让对方在某件事发生之后再来调用它。MDN 把回调函数定义为作为参数传给另一个函数、并由后者调用来完成某种动作的函数(MDN)。名字就说明了一切:你交出一个函数,对方准备好了就「回头调用」。

function greet(name, done) {
  console.log('Hello, ' + name);
  done();               // 回调
}
greet('Ada', function () { console.log('finished'); });

你交出的是什么时候运行这个函数的控制权。这一点解释了人们遇到回调时大部分的意外,本页其余部分讲的就是这些意外。

在编程之外,「callback」还有别的意思:给某人回的第二个电话、试镜的第二轮、呼应前面某个笑话的包袱。本页讲的是编程里的含义。

同步回调和异步回调

MDN 按运行时机区分回调:同步(立即,在调用之内)或异步(之后,在当前代码结束之后)。分析副作用时,时机很关键。

类型什么时候运行JavaScript 里的例子
同步在调用它的函数返回之前Array.prototype.map()、forEach()、sort() 的比较函数
异步当前代码结束之后,事件或定时器触发时setTimeout()、事件监听、网络请求、Promise.then()

用一小段代码检验两者的区别,输出按顺序:

console.log('A');
setTimeout(function () { console.log('B'); }, 0);
[1].forEach(function () { console.log('C'); });
console.log('D');
// A, C, D, B

forEach 立即运行它的回调,所以 C 排在 D 之前。定时器回调要等当前代码跑完,所以即使延迟为零,B 也排在最后。

回调用在哪些地方

  • 事件处理。「点击这个按钮时,运行这个函数」,这个处理函数就是回调。
  • 异步工作。 读文件、网络请求或定时器,在结果就绪时调用你的函数。
  • 定制通用函数。 用你自己的比较方式排序,或用你自己的条件过滤。
  • 库向你汇报。 SDK 在成功、失败或状态变化时调用你的函数。

同样的形式在许多语言里都有:C 传函数指针,Python 传函数,Java 传接口对象或 lambda。

要清楚对方到底传哪些参数。参数由调用方提供,回调只收到被发过来的东西。array.map(function (item, index, array) { ... }) 按顺序传入元素、它的位置和整个数组;如果回调期望的顺序不同,就会悄悄地出错。读一读你要把函数交给的那个函数的文档;如果你是调用方,就在注释里写明顺序。

能避免大部分 bug 的约定

  1. 错误优先。 许多接口按 callback(error, result) 调用:先检查 error,没有错误才用 result。这样不可能忘了处理失败。
  2. 只调用一次。 一个可能触发两次的回调(成功一次、之后失败又一次)会带来重复工作。
  3. 要么总是同步,要么总是异步。 一个函数有时立即回调、有时稍后回调,很难推理;选一种。
  4. 保留你自己的上下文。 回调可能在不同的 this 下运行,或在变量变化之后运行;把你需要的值先保存下来。
  5. 明确处理失败。 回调内部未处理的错误,往往没地方去。

算例:串行回调和并行工作

示例数据:一个页面需要用户(120 毫秒)、他的订单(200 毫秒)和他的推荐(150 毫秒)。三者都不需要别人的结果。

写法怎么运行总耗时
嵌套回调,一个接一个先用户,再订单,再推荐120 + 200 + 150 = 470 毫秒
三个同时发起等最慢的那个max(120, 200, 150) = 200 毫秒

复算:120 + 200 + 150 = 470,三者中最慢的是 200。因为这些请求互不依赖,嵌套白白让页面慢了 270 毫秒。

嵌套还会造成「厄运金字塔」:每一步都深一层,每一层都要重复错误处理。MDN 的 Promise 指南就把这个金字塔作为引入 Promise 的动机,Promise 把链条拉平,错误只在一个地方捕获(MDN:Using promises)。判断规则:步骤互相依赖,就串起来;不依赖,就同时发起。

回调、Promise 和 async/await

方式优点缺点
回调简单,到处能用,不需要额外概念嵌套;错误处理分散
Promise链条平,一个 catch要学一个新对象;容易忘记 return
async / await读起来像普通代码底层还是 Promise;默认是串行的

Promise 并没有取消回调,.then() 本身就接收一个回调。它们改变的是谁掌握控制流。在事件处理、旧的库和 SDK 选项里,你仍然会遇到回调。

常见误区

  • 以为回调已经运行了。 异步调用之后的代码会先运行。需要结果,就在回调里用。
  • 调用函数而不是传函数。 setTimeout(go(), 100) 现在就运行 go,传进去的是它的返回值;你要的是 setTimeout(go, 100)。
  • 丢失错误。 异步回调里抛出的失败,到不了启动它的那段代码。
  • 页面退出时还指望能做等不及的事。 网络请求之后的回调,如果页面先关了,可能永远不会运行。未捕获的错误怎么出现,参见 JavaScript 错误。
  • 把「回调」和「Webhook」当成一回事。 Webhook 是跨网络的回调:你给的是一个网址,不是一个函数。

统计代码里的回调与 TapCub

回调在统计里出现在几个具体的地方。以下按 TapCub 文档里的行为来说:

  1. 单页应用的页面浏览。 如果你的路由不改变地址,就在路由器的「路由就绪」回调里调用 window.tapcub.pageview(),让页面数据准备好之后再发这次浏览。如果自动记录已开启、网址已经变了,就不要再调用,否则 2 秒窗口过后会出现第二行。
  2. 服务端和移动端 SDK 的错误。 服务端 SDK 有 onError 选项(Python 里叫 on_error),在批次被丢弃或被拒时调用;Android SDK 还提供 onConsentChange、onSessionStart、onError 和 init(callback),在主线程运行。这个回调里出现 send_failed 这样的代码,说明 SDK 放弃了某个批次,参见文档里的 SDK 网络说明。
  3. 不要等统计。 网站脚本优先用 sendBeacon,其次是带 keepalive 的 fetch,没有本地队列,所以页面关闭前没发出去的那一次就丢了。不要让页面跳转依赖统计回调。
  4. 在数据里验证结果。 接好路由就绪回调之后,到 网站统计 › 实时 或 网站统计 › 页面 确认每次路由变化只有一次浏览。

TapCub 不运行你的回调,也不修异步代码;它记录你的代码上报的内容。全端分析 › 数据管理 › 埋点方案 里计划好的事件名,可以通过实时验证的计数,看出回调有没有按预期触发。

资料来源

这个解释清楚吗?

我们会根据反馈修改和补充这篇内容。

苏禾

数据分析师

围绕流量来源、转化漏斗与用户留存写作,重视指标口径和分析过程,用具体示例解释数字背后的问题。

常见问题

常见追问

大家看完定义后最常问的几个问题。

还有其他问题?

直接和 TapCub 团队聊聊——工作日通常几小时内回复。

回调用大白话怎么说?

就是你把一个函数交给别人的代码,并说「做完了就调用这个」。做什么由你决定,什么时候做由对方决定。

回调和函数有什么区别?

任何函数都可以当回调用。这个词描述的是用法:它被当作参数传出去,由别的代码之后再调用,而不是由你直接调用。

什么是回调地狱?

层层嵌套的回调,每一个都在上一个里面发起,每一层都要重复错误处理。Promise 和 async/await 把链条拉平,错误只在一个地方捕获。

回调和 Webhook 是一回事吗?

思路相似,位置不同。回调是在一个程序内部被调用的函数;Webhook 是跨网络的回调:你给一个网址,事件发生时对方系统向它发一个 HTTP 请求。

在你自己的网站上看这个数字

加一行脚本就能开始,网站和 App 都能接,几分钟内就能看到第一批报表。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie