sync.Once 是 Go 语言标准库 sync 包提供的一个类型，它用于确保一个函数只会被执行一次，即使在多个 goroutine 中同时调用。

sync.Once 包含一个 Do 方法，其签名如下：

func (o *Once) Do(f func()) 

Do 方法接受一个函数作为参数，并且保证该函数只会被调用一次，即使在多个 goroutine 中同时调用 Do 方法。

通常，sync.Once 的用法是在需要确保某个操作只执行一次的情况下使用，比如在初始化全局变量时。

以下是一个示例：

package mainimport ("fmt""sync"
)var (once sync.Oncenum  int
)func setup() {num = 42fmt.Println("Setup complete")
}func main() {for i := 0; i < 3; i++ {once.Do(setup)fmt.Println(num)}
}

在上述示例中，setup 函数将被 sync.Once 确保只会执行一次，即使在多次调用 once.Do(setup) 也是如此。这保证了 num 变量只会被初始化一次。