当前位置：首页 > 文章列表 > Golang > Go问答 > Go sync.Map LoadOrStore 怎样判断是否写入新值

Go sync.Map LoadOrStore 怎样判断是否写入新值

来源：17golang原创 2026-11-14 16:24:33 0浏览收藏

Go 的 sync.Map.LoadOrStore 返回两个值：actual 和 loaded。判断本次调用是否真的把候选值写入 map，不要比较 actual 和传入值，而是直接看 loaded：false 表示本次完成了写入，true 表示键已经存在，本次只读到了旧值。

记住一句话：loaded == false 是“我写入了”，loaded == true 是“别人或之前的调用已经写入了”。无论哪种情况，最终应该使用返回的 actual。

两个返回值分别表示什么

LoadOrStore(key, value) 先按 key 查找。找到已有值时返回已有值；找不到时尝试保存传入的 value，并返回它。第二个返回值只描述这次调用观察到的路径，不是 map 中值的类型判断。

sync.Map LoadOrStore 的 key、候选值、actual 和 loaded 静态关系说明图 — 图1：结构说明图，展示 key、候选值与两个返回值之间的静态契约，不是运行截图。

最小写法如下，注意分支判断的是 loaded，而后续业务统一使用 actual：

package main

import (
    "fmt"
    "sync"
)

func main() {
    var cache sync.Map

    // loaded=false 表示本次把 candidate 写入；true 表示复用了已有值。
    actual, loaded := cache.LoadOrStore("user:42", "ready")
    if loaded {
        fmt.Println("复用已有值：", actual)
        return
    }

    // actual 仍是最终写入的值，后续逻辑不必再次 Load。
    fmt.Println("完成首次写入：", actual)
}

并发场景怎样确认谁真正写入

多个 goroutine 同时使用同一个 key 时，只有一个调用能拿到 loaded=false。其他调用会拿到同一个 key 的已存在值，并得到 loaded=true。因此可以把“首次登记”“去重占位”“缓存首写”放到 !loaded 分支，把所有调用都需要的后续处理放在返回值统一的位置。

import "fmt"

type entry struct {
    Owner string
}

func register(m *sync.Map, key string, candidate *entry) *entry {
    // 指针让调用方明确区分候选对象与最终共享对象。
    actual, loaded := m.LoadOrStore(key, candidate)
    if !loaded {
        // 只有这里的调用负责记录“首次登记”动作。
        fmt.Println("首次登记：", key)
    }

    // 无论是否首次写入，业务都应使用 map 返回的最终对象。
    return actual.(*entry)
}

这段代码的关键不是“谁先运行到函数”，而是 LoadOrStore 返回的 loaded。如果把候选指针当成最终对象继续修改，其他调用可能仍然持有另一份未被保存的候选值；应始终以 actual 为准。