atomic.LoadUint64总返回0通常因传入未初始化或栈上临时变量的地址;须确保指针指向包级变量或堆分配的持久内存。
常见错误是把 uint64 变量地址传给 atomic.LoadUint64,但变量本身没初始化,或者传了栈上临时变量的地址。该函数只接受 *uint64,且要求地址有效、生命周期足够长。
new(uint64))var x uint64; p := &x)var counter uint64 = 100
// ✅ 正确:包级变量,地址稳定
fmt.Println(atomic.LoadUint64(&counter))
// ❌ 错误示例(编译能过,但行为未定义):
// func bad() {
// var x uint64 = 42
// fmt.Println(atomic.LoadUint64(&x)) // x 在函数返回后失效
// }
atomic.CompareAndSwapInt32 返回 bool 表示“旧值匹配且已更新”。它不抛异常,也不重试——这是设计使然。你得自己决定是否重试、何时放弃、要不要加 backoff。
0 → 1 表示“启动中”)runtime.Gosched() 或短时休眠var state int32 = 0
for !atomic.CompareAndSwapInt32(&state, 0, 1) {
// 当前 state 不是 0,说明已被其他 goroutine 占用
// 可选择继续等待、返回错误,或稍作让出
runtime.Gosched()
}
Go 的 atomic.StorePointer 和 atomic.LoadPointer 操作的是 unsafe.Pointer,不进行类型

*A 却当 *B 读),就会触发未定义行为,甚至崩溃。
unsafe.Pointer(&x) 存,用 (*T)(atomic.LoadPointer(&p)) 读,且 T 必须和存入时的原始类型完全一致unsafe.Pointer,容易丢失类型上下文unsafe
var ptr unsafe.Pointer
type Config struct{ Timeout int }
cfg := &Config{Timeout: 5}
atomic.StorePointer(&ptr, unsafe.Pointer(cfg))
// ✅ 正确读取
loaded := (*Config)(atomic.LoadPointer(&ptr))
fmt.Println(loaded.Timeout) // 5
原子操作只保证单个值的读写线性化,无法原子地更新两个关联字段(如 count 和 sum)。试图用多个 atomic 操作拼凑“逻辑原子性”,大概率导致中间态被其他 goroutine 观察到,引发数据不一致。
sync.Mutex 或 sync.RWMutex
atomic 适合高性能热点路径:计数器、开关标志、单指针替换、序列号生成等atomic 不提供内存屏障之外的同步语义,比如不会阻止编译器或 CPU 重排非原子访问真正难的不是调用哪个函数,而是判断“这里到底需不需要原子性”以及“这个变量的修改是否独立于其他状态”。很多并发 bug 源于过早优化——先用 sync.Mutex 写正确,再看 profile 数据决定是否值得换成 atomic。