go 中若将 sync.mutex 以值类型嵌入结构体并直接返回该结构体，会导致互斥锁被复制，使并发保护完全失效；正确做法是返回结构体指针，而非结构体值。
go 中若将 sync.mutex 以值类型嵌入结构体并直接返回该结构体，会导致互斥锁被复制，使并发保护完全失效；正确做法是返回结构体指针，而非结构体值。
在 Go 并发编程中，sync.Mutex 是一个不可复制的类型（non-copyable）。其内部包含操作系统级的同步原语（如 futex）和状态字段（如 state、sema），一旦被复制（例如通过结构体赋值或函数返回值传递），副本与原锁完全独立——对副本加锁/解锁不会影响原锁，从而彻底破坏临界区保护逻辑。
以下代码即存在严重隐患：
type Groups struct {
sync.Mutex // ❌ 值嵌入
Names []string
}
func NewGroups(names ...string) (Groups, error) {
return Groups{Names: names}, nil // ⚠️ 返回结构体值 → Mutex 被复制！
}调用方若这样使用：
g1 := NewGroups("a", "b")
g2 := NewGroups("c", "d") // g1.Mutex 与 g2.Mutex 完全无关
// 即使 g1.Lock()，也无法阻止 g2 同时修改其 own Names —— 竞态风险暴露go vet 的警告 NewGroups returns Lock by value: Groups 正是对此类错误的精准捕获。
✅ 推荐修复方案：返回结构体指针
保持 sync.Mutex 值嵌入（语义清晰、无需手动解引用），但让构造函数返回 *Groups：
type Groups struct {
sync.Mutex // ✅ 值嵌入，但通过指针访问
Names []string
}
func NewGroups(names ...string) (*Groups, error) {
return &Groups{Names: names}, nil // ✅ 返回指针，Mutex 不被复制
}
// 使用示例
func main() {
g, _ := NewGroups("user1", "user2")
g.Lock()
defer g.Unlock()
g.Names = append(g.Names, "user3")
}⚠️ 注意：*不建议嵌入 `sync.Mutex**（如*sync.Mutex` 字段）。虽然技术上可避免复制，但会带来额外风险：
- nil 指针调用 Lock() 将 panic；
- 丧失结构体内嵌带来的方法提升（g.Lock() 可直接调用，而 *sync.Mutex 需显式 g.Mutex.Lock()）；
- 违反 Go 社区惯用法（标准库如 sync.RWMutex、http.ServeMux 均采用值嵌入 + 指针使用）。
? 关键原则总结：
- sync.Mutex 必须以值形式嵌入结构体（保障方法提升与语义一致性）；
- 包含 sync.Mutex 的结构体绝不应作为函数返回值或参数按值传递；
- 所有对该结构体的并发访问，必须通过指针进行（*T），确保所有 goroutine 操作的是同一内存地址上的锁实例。
遵循此模式，即可彻底规避锁复制导致的竞态问题，写出线程安全、符合 Go idioms 的并发代码。
