Go 的 time 包通过 time.Ticker 和 time.AfterFunc 可实现轻量周期任务;time.Ticker 适合固定间隔循环执行,需调用 Stop() 防泄漏。

用 Go 的 time 包可以轻松实现简单、轻量的周期性定时任务,无需引入第三方库。核心在于 time.Ticker 和 time.AfterFunc,适用于对精度要求不高、不需持久化或分布式支持的场景。
使用 time.Ticker 实现固定间隔循环任务
time.Ticker 是最常用的方式,适合需要持续、规律执行的任务(如每 5 秒检查一次状态)。它会按指定周期发送时间戳到通道,配合 select 可安全退出。
- 创建 Ticker:用
time.NewTicker(duration),例如tick := time.NewTicker(10 * time.Second) - 在 goroutine 中监听
tick.C,每次收到时间即执行任务逻辑 - 务必在退出前调用
tick.Stop(),避免 goroutine 泄漏和资源占用
示例片段:
go func() {tick := time.NewTicker(5 * time.Second)
defer tick.Stop()
for {
select {
case log.Println("执行周期任务")
case return
}
}
}()
使用 time.AfterFunc 实现单次延迟或伪周期任务
time.AfterFunc 适合只执行一次的延后任务;若想模拟周期行为,可在函数体内递归调用自身(注意控制并发与退出)。
立即学习“go语言免费学习笔记(深入)”;
- 基本用法:
time.AfterFunc(3*time.Second, func(){ ... }) - 实现“伪周期”:在回调函数末尾再次调用
AfterFunc,但要避免无限嵌套导致栈溢出,推荐用 goroutine 封装 - 需自行管理停止逻辑,例如用原子变量或 channel 控制是否继续调度
示例(带退出控制):
go func() {var stop int32
run := func() {
if atomic.LoadInt32(&stop) == 1 { return }
log.Println("执行一次任务")
time.AfterFunc(8*time.Second, run)
}
run()
// 停止时:atomic.StoreInt32(&stop, 1)
}()
结合 context 控制生命周期,避免 goroutine 泄漏
真实项目中,任务常随服务启停而启动/取消。context.Context 是标准做法,可与 time.Ticker 安全协同。
- 用
context.WithCancel或context.WithTimeout创建可取消上下文 - 在 select 中监听
ctx.Done(),收到信号后主动Stop()Ticker 并返回 - 推荐封装成函数,接收
context.Context和间隔时长,提升复用性
注意事项与局限性
time 包方案简洁高效,但有明确边界:
- 不支持 cron 表达式(如 “0 0 * * *”),需手动解析或换用
robfig/cron等库 - 不保证绝对准时——受 GC、调度延迟影响,通常误差在毫秒级,适合容忍度较高的业务
- 无任务失败重试、持久化、分布式协调能力,高可用场景建议用专用调度系统(如 Quartz、Temporal)










