Go 的 sync/atomic.Pointer 仅支持可比较类型（如 struct、int、string）的指针，不支持 func/map/slice/chan；传入非法类型运行时 panic；需用 struct 包装不可比较类型，或改用 sync.RWMutex；Store/Load 仅保证原子性，无内存序保证；CompareAndSwap 是唯一无锁更新入口，比较指针地址而非内容；禁止与 unsafe.Pointer 混用；零值 Load 返回 nil，必须显式初始化。
Go 的 sync/atomic.Pointer 不能直接存任意指针
它只接受 *T 类型的指针，且 T 必须是「可比较类型」（即能用 == 判断相等），比如 struct、int、string；但不能是 func、map、slice、chan 或包含它们的结构体。一旦传入不满足条件的指针，编译期不会报错，但运行时调用 Load/Store 会 panic：panic: sync/atomic: pointer operation on unsupported type。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 定义指针类型前先检查底层类型是否可比较：用
reflect.TypeOf(T{}).Comparable()验证（仅调试用） - 常见踩坑：想原子更新
*[]int或*map[string]int—— 不行，得包装成 struct：type Wrapper struct { data map[string]int }，再用*Wrapper - 如果只是需要线程安全地替换整个 map/slice，更稳妥的做法是用
sync.RWMutex+ 普通指针，而非硬套Pointer
Store 和 Load 是原子的，但不保证内存可见性以外的语义
它们只确保读写本身不被中断、不撕裂，不提供顺序一致性（sequential consistency）之外的更强保证。比如：没有隐式 acquire/release 栅栏，也不阻止编译器或 CPU 重排其他非原子操作。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 若需配合其他变量同步（如先改数据，再改状态标志），必须显式加
atomic.StoreInt64等带内存序的原子操作，或用atomic.Pointer.CompareAndSwap做条件更新 - 不要依赖
Load后立即读某个非原子字段的值 —— 它可能还是旧的，除非你额外加屏障（如runtime.Gosched()不解决，得用atomic.LoadXXX配套） - 典型场景：配置热更新。把
*Config存进atomic.Pointer[Config]，每次新配置构造完再Store，下游Load到的就是完整、一致的新结构体
CompareAndSwap 是唯一能实现无锁更新逻辑的入口
它不是简单的“CAS 循环”，而是原子地判断当前指针值是否等于预期值，若是，则替换成新值并返回 true；否则返回 false。这让你能实现引用级别的乐观并发控制，比如实现一个无锁的单例配置切换器。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 别在循环里裸写
for !p.CompareAndSwap(old, new) { old = p.Load() }—— 如果old是局部变量，可能因 GC 或并发修改导致意外失败；应确保old是上一次Load的结果，且生命周期可控 - 注意：比较的是指针地址，不是结构体内容。两个内容相同但地址不同的
*Config，CompareAndSwap会认为不等 - 示例片段：
var configPtr atomic.Pointer[Config] // 初始化 configPtr.Store(&defaultConfig) // 更新时 for { old := configPtr.Load() newCfg := &Config{...} // 构造新实例 if configPtr.CompareAndSwap(old, newCfg) { break } // 可选：加短暂休眠或限重试次数，避免活锁 }
和 unsafe.Pointer 混用是危险区
atomic.Pointer 内部用 unsafe.Pointer 实现，但它封装了类型安全检查。一旦你绕过它，用 unsafe 直接操作其内部字段，就彻底脱离 Go 类型系统保护，极易引发静默错误或崩溃。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 绝对不要对
atomic.Pointer[T]的字段做unsafe.Offsetof或反射取址 - 不要试图用
unsafe.Pointer把*int强转成*string再塞进去 —— 即使编译通过，运行时Load会 panic 或读出垃圾值 - 真正需要跨类型原子指针？说明设计已偏离 Go 原子包本意，该回归互斥锁或重新建模数据结构
最常被忽略的一点：atomic.Pointer 的零值是有效且安全的，但它的 Load 返回 nil 指针 —— 如果你没初始化就直接 Load 并解引用，会 panic。初始化不是可选项，是必做动作。
