【声明】本博客所有内容均为个人业余时间创作，所述技术案例均来自公开开源项目（如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 篇那行代码长这样：
setTimeout(()=>{client.call("checkUpgrade",{directory:cwd})},1000)这用的是"内联箭头 + 闭包"。但setTimeout(fn, delay, ...args)的完整签名里，第一个参数可以传箭头函数、可以传函数引用，delay 之后还能带参数。七种形式先一并列出：
🧩七种形式一览
// ① 内联箭头 + 闭包捕获（最常见，opencode 用法）setTimeout(()=>{client.call("checkUpgrade",{directory:cwd})},1000)// ② 函数引用 + 第三参数传值（参数注册时固化）setTimeout(console.log,0,i)// ③ 函数引用（无参）——传名字不加括号setTimeout(doSomething,1000)// ④ 字符串（已弃用，eval 风险）setTimeout("console.log('hi')",1000)// ⑤ 递归代替 setInterval（任务结束再排下一个，防堆积）functiontick(){/* ... */setTimeout(tick,1000)}// ⑥ 延迟 0 排队（下一次宏任务）setTimeout(fn,0)// ⑦ 生命周期管理（取消 / 不阻挡退出）constt=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)（传引用）vssetTimeout(fn(), 0)（立即调用，传返回值）——后者几乎总是错误。
📌一句话记忆
setTimeout 七种形式本质是三个自由度的组合：回调怎么写（箭头内联 / 函数引用 / 递归）、数据怎么给（闭包捕获 / 第三参数快照 / 不喂）、生命周期怎么管（clearTimeout / unref / 延迟 0 排队）。200 篇用的是"①箭头+闭包"，下一篇讲它的对立面"②函数引用+参数"到底何时用。
OK，本篇先到这里，如有疑问，欢迎评论区留言讨论，祝各位功力大涨，技术更上一层楼！！！更多内容见下篇 blog
【Agent】【OpenCode】JS 语法：闭包捕获还是参数传递
