【声明】本博客所有内容均为个人业余时间创作，所述技术案例均来自公开开源项目（如Github，Apache基金会），不涉及任何企业机密或未公开技术，如有侵权请联系删除
标题
201、【Agent】【OpenCode】JS 语法：setTimeout 七种常用形式
背景
上篇 blog
【Agent】【OpenCode】TuiThreadCommand handler：checkUpgrade 的延迟与 unref
拆了 thread.ts:197-199 那行延迟升级检测的四个细节：setTimeout 是运行时全局内置定时器（返回带 unref 的 Timeout 对象）；回调写成无参箭头函数、靠闭包捕获 client/cwd；client.call("checkUpgrade") 是 TUI 发往 worker 的 RPC 请求（失败 .catch 静默）；unref 让定时器不阻挡进程退出、?. 防御"返回对象没有 unref"的环境。200 里 setTimeout 的回调用了"内联箭头 + 闭包"这一种形式，但 setTimeout 的写法远不止这一种------本篇开启新系列 "JS 语法"（通用 JS 语法点统一归入），先盘点 setTimeout 的七种常用形式
OpenCode
200 篇那行代码长这样：
ts
setTimeout(() => {
client.call("checkUpgrade", { directory: cwd })
}, 1000)这用的是"内联箭头 + 闭包"。但 setTimeout(fn, delay, ...args) 的完整签名里，第一个参数可以传箭头函数、可以传函数引用，delay 之后还能带参数。七种形式先一并列出：
🧩 七种形式一览
ts
// ① 内联箭头 + 闭包捕获（最常见，opencode 用法）
setTimeout(() => { client.call("checkUpgrade", { directory: cwd }) }, 1000)
// ② 函数引用 + 第三参数传值（参数注册时固化）
setTimeout(console.log, 0, i)
// ③ 函数引用（无参）------传名字不加括号
setTimeout(doSomething, 1000)
// ④ 字符串（已弃用，eval 风险）
setTimeout("console.log('hi')", 1000)
// ⑤ 递归代替 setInterval（任务结束再排下一个，防堆积）
function tick() { /* ... */ setTimeout(tick, 1000) }
// ⑥ 延迟 0 排队（下一次宏任务）
setTimeout(fn, 0)
// ⑦ 生命周期管理（取消 / 不阻挡退出）
const t = setTimeout(fn, 1000)
clearTimeout(t)
t.unref()🧩 逐个拆解
形式① 内联箭头 + 闭包 ：箭头函数内联定义，要用的变量（client/cwd）从外层闭包捕获。这是 opencode 里的写法，也是日常最常见。
形式② 函数引用 + 第三参数 ：setTimeout(console.log, 0, i) 第一参数传 console.log 这个函数引用（没有括号），第三参数 i 在定时器触发时作为实参传给回调，在注册那一刻被固化 （快照）。等价于 setTimeout((...args) => console.log(...args), 0, i)。
形式③ 函数引用（无参） ：setTimeout(doSomething, 1000) 传函数名字（不加括号）。注意与 setTimeout(doSomething(), 1000) 的区别------后者是立即调用并传返回值，几乎总是 bug。
形式④ 字符串（弃用） ：早期允许传字符串，内部 eval 执行，有安全与性能问题，现代代码不应使用，了解即可。
形式⑤ 递归代替 setInterval ：setInterval 固定间隔可能在前一次任务没跑完时就触发（堆积）；递归版每次任务结束后才排下一个，天然防堆积、可控。
形式⑥ 延迟 0 排队 ：setTimeout(fn, 0) 不是立刻执行，而是把 fn 排到当前任务栈清空后的下一次宏任务，用于"先让当前代码跑完，再异步补齐"。
形式⑦ 生命周期管理 ：setTimeout 返回定时器对象------clearTimeout 取消；unref 把它标记为次要任务，事件循环没有别的事时进程可直接退出（Node/Bun）。
📊 七种形式对照
| 形式 | 写法 | 数据注入 | 适用 |
|---|---|---|---|
| ① 内联箭头 + 闭包 | setTimeout(() => fn(), d) |
闭包（实时引用） | 最常见，作用域内取值 |
| ② 函数引用 + 第三参数 | setTimeout(fn, d, arg) |
参数（注册时快照） | 复用函数、要快照值 |
| ③ 函数引用（无参） | setTimeout(fn, d) |
无 | 回调自足、无参 |
| ④ 字符串 | setTimeout("code", d) |
无 | 弃用（eval 风险） |
| ⑤ 递归代替 interval | function t(){...;setTimeout(t,d)} |
闭包 | 防任务堆积 |
| ⑥ 延迟 0 | setTimeout(fn, 0) |
闭包 | 下一次宏任务排队 |
| ⑦ 生命周期 | t=setTimeout(...);clearTimeout(t);t.unref() |
--- | 取消 / 不挡退出 |
最容易踩的坑 ：setTimeout(fn, 0)（传引用）vs setTimeout(fn(), 0)（立即调用，传返回值）------后者几乎总是错误。
📌 一句话记忆
setTimeout 七种形式本质是三个自由度的组合：回调怎么写 （箭头内联 / 函数引用 / 递归）、数据怎么给 （闭包捕获 / 第三参数快照 / 不喂）、生命周期怎么管（clearTimeout / unref / 延迟 0 排队）。200 篇用的是"①箭头+闭包"，下一篇讲它的对立面"②函数引用+参数"到底何时用。
OK，本篇先到这里，如有疑问，欢迎评论区留言讨论，祝各位功力大涨，技术更上一层楼！！！更多内容见下篇 blog