time.Timer适用于一次性延时任务,如5秒后发送通知;需周期性执行应使用time.Ticker。通过NewTimer创建后,可监听其C通道等待触发,用Stop停止以避免资源泄漏,Reset可重设超时时间,常用于连接保活等场景。注意Stop后需处理C通道残留值,已触发的Timer需Reset才能复用,单次延迟可用更简洁的time.After。

在Go语言中,time.Timer 是实现延时执行任务的一种方式。它并不适合周期性任务,而是用于“在未来某个时间点执行一次”的场景。如果你需要定时重复执行任务,应优先考虑 time.Ticker。但若只是想延迟执行一段逻辑,比如 5 秒后发送通知、10 秒后关闭连接等,time.Timer 就很合适。
1. 基本用法:创建并等待Timer触发
使用 time.NewTimer 创建一个定时器,指定超时时间,然后通过它的 C 字段(一个 channel)来接收到期信号。
示例:2秒后执行任务
package mainimport ( "fmt" "time" )
func main() { timer := time.NewTimer(2 * time.Second) fmt.Println("开始等待...")
<-timer.C // 阻塞直到定时器触发 fmt.Println("2秒已到,执行任务")}
立即学习“go语言免费学习笔记(深入)”;
2. 停止Timer:防止资源浪费
如果在定时器触发前不再需要它,应调用 Stop() 方法停止,避免不必要的系统资源占用和潜在的 goroutine 泄漏。
常见于用户取消操作或任务提前完成的场景。
timer := time.NewTimer(5 * time.Second)go func() { time.Sleep(3 * time.Second) if timer.Stop() { fmt.Println("定时器已成功停止") } }()
<-timer.C // 如果已被 Stop,channel 不会再触发
注意:即使 Stop 成功,C channel 中可能已有值,需判断是否已触发。
3. 重置Timer:重新设定超时时间
使用 Reset() 可以让已创建或已触发的 Timer 重新开始计时。这在需要反复延迟执行同一任务时很有用,比如心跳超时重置。
示例:模拟连接保活,每次收到消息重置超时
timer := time.NewTimer(3 * time.Second)// 模拟外部事件流 done := make(chan bool)
go func() { for { select { case <-done: return case <-time.After(2 time.Second): // 模拟收到消息 if !timer.Stop() { <-timer.C // 清空已触发的 channel } timer.Reset(3 time.Second) // 重置超时 fmt.Println("超时重置") case <-timer.C: fmt.Println("超时,断开连接") return } } }()
time.Sleep(10 * time.Second) done <- true
4. 注意事项与最佳实践
- Timer 触发后,其 C channel 会释放一个时间值,之后不会再有数据。如需重复使用必须调用 Reset。
- Stop 返回 bool 表示是否成功阻止了触发(true 表示未触发就被停掉)。
- Stop 后仍需处理 C channel 可能存在的待读取值,避免阻塞或误判。
- 不要对已触发且未重置的 Timer 再次调用 Stop 或 Reset,行为不确定。
- 对于只延迟一次的任务,也可以直接用 time.After,更简洁:
<-time.After(2 * time.Second)
fmt.Println("延迟2秒执行")
但注意:time.After 返回的 channel 没有显式关闭途径,长时间运行中频繁使用可能导致内存泄漏,此时建议用 Timer 并配合 Stop。
基本上就这些。Timer 简单直接,关键是理解其一次性特性以及如何安全地停止和重用。不复杂但容易忽略细节。










