Golang结构体传值和传指针如何选择_结构体参数设计建议

必须用指针传参：结构体含 slice/map/chan/interface{} 字段、含 sync.Mutex 等非可复制字段、需修改字段或并发共享；小结构体（≤16 字节）传值更高效。

什么时候必须用指针传参

结构体含 slice、map、chan 或 interface{} 字段时，值传递看似“安全”，实则危险：这些字段内部包含指针，值拷贝后仍共享底层数据，但结构体头（如 len/cap）是独立的。一旦函数内做 append 或 make，原结构体完全感知不到——这不是你想要的“隔离”，而是“意外失联”。更关键的是，sync.Mutex 等零值有效的同步原语，**绝不能传值**，否则锁失效（Go 会 panic）。

• 必须用指针：结构体含 sync.Mutex、sync.RWMutex 等非可复制字段
• 必须用指针：需要在函数中修改结构体字段（如库存扣减、状态更新）
• 必须用指针：结构体被多个 goroutine 共享且需并发修改

小结构体传值反而更高效

像 type Point struct{ X, Y int } 或 type UserID string 这类 ≤16 字节的小结构体，传值比传指针更快。现代编译器能将其放入 CPU 寄存器，避免内存访问和解引用延迟；而指针虽只占 8 字节，却强制一次内存读取 + 解引用，反而多一次间接跳转。基准测试显示，在 amd64 上，16 字节以内结构体值传递平均快 5%–15%。

• 推荐值传递：字段 ≤2 个 int/string（不含大字符串）、无引用类型、总大小 ≤16 字节
• 值传递天然防误改：调用方数据绝对安全，适合只读计算（如 func (p Product) PriceWithTax() float64）
• 别迷信“统一用指针”——Go 标准库里 time.Time、net.IP 都是值类型，就因小且不可变

方法接收者不等于参数传递，但必须一致

如果你定义了 func (p *Product) Save()，那所有调用点都该用 *Product 变量。虽然 Go 允许用值变量调用指针方法（自动取地址），但前提是该值**不逃逸到堆上**——临时结构体字面量 &Product{} 没问题，但 Product{} 直接传给 Save() 会触发编译错误：cannot call pointer method on Product literal。

• 接收者用指针 → 调用方变量最好也声明为指针（如 p := &Product{...}），避免隐式取地址带来的逃逸
• 接收者用值 → 无法修改字段，且若结构体较大，每次调用都复制，性能雪崩
• 导出结构体对外暴露的方法，优先用指针接收者：既支持修改，又避免包外用户意外传值导致方法不可调用

工厂函数返回值别犹豫，直接返指针

工厂函数（如 NewConfig()、ParseJSON(...)）几乎总是该返回 *T。原因很实在：返回值若为值类型，调用方必须再取地址才能传给需要指针的其他函数；若工厂本身已分配内存（比如解析 JSON 到结构体），再复制一次纯属浪费。更重要的是，返回指针明确传达“这是可共享、可修改的实例”语义。

立即学习“go语言免费学习笔记（深入）”；

• 返回指针：避免调用方二次分配，减少 GC 压力（尤其高频创建场景）
• 返回指针：与标准库习惯一致（json.Unmarshal 要求 *T，http.NewRequest 返回 *http.Request）
• 例外极少：仅当结构体极小（≤8 字节）且明确设计为不可变值对象（如 type Status uint8）才考虑返回值

func NewProduct(name string, price float64) *Product {
    return &Product{
        ID:    uuid.New().String(),
        Name:  name,
        Price: price,
        Stock: 100,
    }
}

// ✅ 正确用法：直接用于指针方法
p := NewProduct("Laptop", 999.99)
p.DeductStock(1)

// ❌ 别这么干：NewProduct() 返回指针，你还手动取地址
p2 := &*NewProduct("Phone", 599.99) // 多余且易空指针 panic