在JavaScript中，setTimeout是一个用于安排代码在指定时间之后执行的全局函数。它属于浏览器或Node.js运行环境提供的定时器机制，并不会阻塞主线程，而是将回调函数放入任务队列，等待当前调用栈清空且达到延迟时间后，由事件循环取出执行。这意味着即便你写了零毫秒延迟，回调也不会立即运行，而是等待同步代码全部完成。
setTimeout的基本语法与参数
setTimeout的函数签名非常直观，第一个参数接收要执行的函数或代码字符串，第二个参数是延迟的毫秒数，后续参数会作为回调函数的实参传入。在绝大多数现代开发中，应避免传入字符串，因为那等价于使用eval，会带来安全和性能问题。推荐始终传入函数引用或匿名函数。
下面是一个最基础的用法示例，我们在延迟一秒后打印一条信息，并演示如何传递额外参数：
// 基础用法：延迟1000毫秒输出
setTimeout(function() {
console.log('一秒后执行');
}, 1000);
// 带参数传递的用法
function greet(name, msg) {
console.log(name + '说：' + msg);
}
// 第三个及之后的参数会传给greet
setTimeout(greet, 500, '小明', '你好');
需要注意的是，setTimeout的返回值是一个定时器标识符，在浏览器中是数字，在Node.js中是Timeout对象。这个标识符是取消定时器的关键，如果延迟时间较长且页面可能发生切换，就应当保存它以便后续清理。
异步特性与事件循环的关系
很多初学者误以为setTimeout的延迟时间是精确的执行时间，实际上它只是“最早可执行时间”。JavaScript是单线程语言，当同步代码或前一个微任务占用大量时间时，回调会被推迟。比如下面这段代码，虽然延迟设为0，但回调必须等循环结束才能运行。
console.log('开始');
setTimeout(function() {
console.log('回调执行');
}, 0);
// 模拟耗时同步操作
for (let i = 0; i < 1e9; i++) {}
console.log('结束');
// 输出顺序：开始 - 结束 - 回调执行
从底层看，setTimeout将回调交给宏任务队列。当前宏任务（脚本整体）执行完，引擎会先清空微任务队列（如Promise回调），再取下一个宏任务。因此延迟时间受微任务堆积影响。在后台标签页中，浏览器还会将最小延迟提升至1000毫秒以节省资源，这也是为什么计时器在切走的页面里变慢了。
清除定时器与内存管理
如果定时器尚未触发，我们可以通过clearTimeout并传入之前的标识符来取消它。这在单页应用路由切换、组件卸载时尤其重要，否则回调函数可能在元素已不存在后执行，引发报错或内存泄漏。
let timerId = setTimeout(function() {
document.body.innerHTML = '加载完成';
}, 3000);
// 假设用户在两秒内离开了页面
function leavePage() {
clearTimeout(timerId);
console.log('已取消未执行的定时器');
}
在框架如React中，常在useEffect的清理函数里调用clearTimeout。对于重复执行的需求则应使用setInterval或递归setTimeout，后者能根据上次执行耗时动态调整间隔，避免任务堆积。无论哪种方式，不用的定时器都应及时清除，保持运行环境干净。
常见误区与最佳实践
一个典型误区是用setTimeout(false, ...)或传递非函数类型作为第一参数，这会导致浏览器尝试将参数转为字符串执行或直接忽略。另外，在循环里直接用var创建多个定时器会共享同一变量，应使用let或闭包隔离。
// 错误示例：var导致输出全是3
for (var i = 0; i < 3; i++) {
setTimeout(function() { console.log(i); }, 100);
}
// 正确写法
for (let j = 0; j < 3; j++) {
setTimeout(function() { console.log(j); }, 100);
}
实践中，若需要精确周期调度且不依赖事件循环空闲度，可考虑Web Workers或requestAnimationFrame处理动画类任务。setTimeout适合一般的延迟与防抖节流场景，配合try-catch包裹回调可防止单个定时器错误中断后续逻辑。掌握这些细节，才能稳妥运用这一基础API。
setTimeoutJavaScript定时器异步执行修改时间：2026-08-06 15:33:26