何时应该返回结构体指针？Go 语言实践指南

本文旨在帮助 Go 语言开发者理解在函数中返回结构体自身还是结构体指针的最佳实践。通过分析性能和 API 设计两个关键因素，并结合标准库中的实例，本文将提供一些指导原则，帮助你做出更明智的决策，优化代码性能和可维护性。

在 Go 语言中，函数返回结构体或结构体指针的选择，是一个需要根据具体情况权衡的设计决策。它涉及到性能、API 设计以及类型的预期使用方式。没有一成不变的规则，但以下几个方面可以作为参考：

1. 结构体的大小与性能

如果结构体很小，比如只包含几个基本类型，那么直接返回结构体通常更有效率。因为复制小结构体的开销很小，避免了额外的指针解引用。但是，如果结构体很大，包含大量的字段，那么返回指针可以避免复制整个结构体，从而提高性能。

例如：

type SmallStruct struct {
A int
B string
}
func CreateSmallStruct() SmallStruct {
return SmallStruct{A: 1, B: "hello"} // 直接返回结构体
}
type LargeStruct struct {
A int
B string
C [1000]int
}
func CreateLargeStruct() *LargeStruct {
return &LargeStruct{A: 1, B: "hello"} // 返回结构体指针
}

在上面的例子中，SmallStruct 很小，直接返回结构体即可。而 LargeStruct 包含一个大的数组，返回指针可以避免复制整个数组的开销。

2. 结构体的可变性与 API 设计

如果结构体是不可变的，也就是说，它的状态不应该被修改，那么直接返回结构体通常是更好的选择。这样可以避免意外修改结构体的值。反之，如果结构体是可变的，并且希望通过函数修改结构体的状态，那么返回指针是必要的。

例如，time.Time 就是一个不可变的结构体，它的方法通常返回一个新的 time.Time 实例，而不是修改自身。

package main
import (
"fmt"
"time"
)
func main() {
now := time.Now()
future := now.Add(time.Hour) // 返回一个新的 time.Time 实例
fmt.Println(now)
fmt.Println(future)
}

另一方面，如果需要修改结构体的状态，则需要返回指针：

package main
import "fmt"
type Counter struct {
count int
}
func Increment(c *Counter) {
c.count++ // 修改结构体状态，需要指针
}
func main() {
c := Counter{count: 0}
Increment(&c)
fmt.Println(c.count) // 输出 1
}

3. 结构体的生命周期

如果结构体需要在函数外部长期存在，那么返回指针是必要的。因为当函数返回时，局部变量会被销毁，如果直接返回结构体，那么函数外部将无法访问到该结构体。

package main
import "fmt"
type Data struct {
value int
}
func CreateData() *Data {
data := Data{value: 10}
return &data // 返回结构体指针，确保在函数外部可以访问
}
func main() {
d := CreateData()
fmt.Println(d.value) // 输出 10
}

4. 标准库的参考

Go 语言的标准库提供了很多优秀的例子，可以作为参考。例如：

• hash/crc32: crc32.NewIEEE() 返回一个指针类型，因为哈希函数实例具有状态。
• time: time.Date() 返回一个 Time 结构体，因为时间是不可变的，且结构体较小。
• math/big: big.NewInt() 返回一个指针，因为 big.Int 可能会很大，避免复制开销。

总结

选择返回结构体还是结构体指针，需要综合考虑性能、API 设计和类型的预期使用方式。

• 返回结构体： 结构体小、不可变、生命周期短。
• 返回结构体指针： 结构体大、可变、需要在函数外部长期存在。

最终的决策取决于具体情况，需要根据实际需求进行权衡。参考标准库的实践，可以帮助你做出更明智的选择。在不确定时，可以进行性能测试，以确定哪种方式更适合你的应用场景。