如何在Go语言中构建一个轻量级的对象池以复用高频使用的结构体模块-Golang-PHP中文网

sync.pool不能直接存结构体值，因会触发拷贝且导致指针/切片/map引用丢失；必须存统一初始化、带reset()方法的指针，reset需归零所有字段并复用内存，获取时判nil，放回前必reset，且仅在对象无外部引用时put。

如何在go语言中构建一个轻量级的对象池以复用高频使用的结构体模块

为什么直接用 `sync.Pool` 不能直接存结构体值

Go 的 sync.Pool 只能存 interface{}，而结构体值传入时会触发拷贝，出池后无法保证字段状态一致；更关键的是，如果结构体含指针、切片或 map，直接存值会导致内部引用丢失或 panic。必须存指针——但不是任意指针，得是统一初始化、可安全 Reset 的指针。

如何定义可复用的结构体并实现 `Reset()`

核心是让结构体具备“归零”能力，否则重复使用会残留旧数据。Reset 方法必须覆盖所有可变字段，包括嵌套结构、切片底层数组、map 等。

结构体字段尽量用指针或可清空类型（如 []byte 而非 string）
Reset() 方法必须显式置空：例如 p.Data = p.Data[:0]、p.Meta = nil、*p.Err = nil
避免在 Reset() 中调用 make 或 new，否则抵消复用收益；重用已有内存即可

示例：

type RequestCtx struct {
    Path   string
    Params map[string]string
    Body   []byte
    Err    error
}

func (r *RequestCtx) Reset() {
    r.Path = ""
    if r.Params != nil {
        for k := range r.Params {
            delete(r.Params, k)
        }
    }
    r.Body = r.Body[:0]
    r.Err = nil
}

怎样安全地从 `sync.Pool` 获取和放回实例

获取时必须检查是否为 nil，因为 Pool 可能返回刚被 GC 清理过的指针；放回前必须调用 Reset()，且不能放回已被外部修改过指针指向的对象（比如已传递给 goroutine 并可能被并发写）。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

获取：用 pool.Get().(*RequestCtx) 强转，但需先判断是否为 nil，nil 时手动 new
放回：只在确定对象生命周期结束、无其他 goroutine 引用时调用 pool.Put()
不要在 defer 中无条件 Put —— 如果函数中途 panic，Reset 可能没执行，下次 Get 到的就是脏数据

典型用法：

var ctxPool = sync.Pool{
    New: func() interface{} {
        return &RequestCtx{
            Params: make(map[string]string),
        }
    },
}

func handleRequest() {
    ctx := ctxPool.Get().(*RequestCtx)
    if ctx == nil {
        ctx = &RequestCtx{Params: make(map[string]string)}
    }
    // ... use ctx ...
    ctx.Reset()
    ctxPool.Put(ctx)
}