sync.Map适用于并发读多写少场景，提供Store、Load、LoadOrStore、Delete和Range方法，避免了传统map的竞态问题，常用于缓存、配置管理及用户状态跟踪，但不支持原子复合操作与一致性遍历快照，需结合类型断言安全使用。
在Go语言中，sync.Map 是专为并发场景设计的高效键值存储结构。它避免了传统 map 配合 mutex 带来的性能开销，适用于读多写少或多个 goroutine 独立读写不同键的场景。直接使用原生 map 在并发写时会触发竞态检测甚至 panic，而 sync.Map 从设计上解决了这个问题。
何时使用 sync.Map
sync.Map 不是普通 map 的完全替代品。它适合以下情况：
- 多个 goroutine 同时读写不同的 key
- 数据集合生命周期内不需要频繁遍历或清理
- 读操作远多于写操作（如缓存、配置管理）
如果需要频繁加锁控制整个 map，或者要做聚合操作（比如统计所有 key），建议仍使用普通 map + RWMutex。
基本操作方法
sync.Map 提供了几个核心方法来完成常见的数据管理：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- Store(key, value)：插入或更新一个键值对
- Load(key)：获取指定 key 的值，返回 (value, bool)
- LoadOrStore(key, value)：若 key 不存在则设置并返回新值，否则返回现有值
- Delete(key)：删除指定 key
- Range(f func(key, value interface{}) bool)：遍历所有键值对，f 返回 false 时停止
示例代码：
func main() {var m sync.Map
// 写入数据
m.Store("name", "Alice")
m.Store("age", 25)
// 读取数据
if val, ok := m.Load("name"); ok {
fmt.Println("Name:", val.(string))
}
// 如果不存在才存入
m.LoadOrStore("email", "alice@example.com")
// 遍历输出
m.Range(func(key, value interface{}) bool {
fmt.Printf("%v: %v\n", key, value)
return true // 继续遍历
})
}
实际应用场景
常见用途包括请求上下文缓存、连接状态管理、去重标记等。例如，在处理大量并发请求时维护每个用户的最后请求时间：
var userLastSeen sync.Map func handleRequest(userID string) {now := time.Now()
userLastSeen.Store(userID, now)
// 处理逻辑...
} // 定期清理过期记录 func cleanupExpired(timeout time.Duration) {
userLastSeen.Range(func(key, value interface{}) bool {
if time.Since(value.(time.Time)) > timeout {
userLastSeen.Delete(key)
}
return true
})
}
这种方式避免了全局锁阻塞所有请求更新操作，提升系统吞吐量。
基本上就这些。sync.Map 使用简单，但要注意它不支持原子性复合操作（如“检查再设值”），也不能保证遍历时的一致性快照。合理评估业务需求后再决定是否采用。不复杂但容易忽略的是类型断言和遍历控制逻辑。确保 Load 返回的 interface{} 正确转回所需类型，避免 panic。
