当前位置：首页 > 文章列表 > Golang > Go教程 > Go atomic.Int64记录并发计数的初始化与读取方式

Go atomic.Int64记录并发计数的初始化与读取方式

来源：17golang原创 2026-09-25 14:48:42 0浏览收藏

并发计数最容易出问题的地方，不是把字段改成 int64，而是让多个 goroutine 同时读写它。Go 现代版本可以直接使用 sync/atomic 提供的 atomic.Int64：字段类型本身表达“这是一个原子值”，写入用 Add 或 Store，读取用 Load，不再把原始整数和原子操作混在一起。

官方文档：https://pkg.go.dev/sync/atomic

如果计数只需要递增和读取，把它声明为 atomic.Int64，创建后用 Load 读取、用 Add(1) 递增；只有需要覆盖当前值时才使用 Store。

要点速览

atomic.Int64 的零值可直接使用，但显式初始化更适合表达业务起点。
Add 返回更新后的值，Load 返回读取瞬间的原子快照。
不要复制已经使用过的原子值，也不要绕过方法直接访问内部状态。

atomic.Int64 的字段声明与初始化边界

类型化原子值适合放在计数器、并发请求数、队列长度等共享状态中。它的零值就是 0，因此下面的结构体不需要额外构造函数也能开始计数：

package counter

import "sync/atomic"

type Stats struct {
	// Requests 只能通过 Add、Load、Store 等原子方法访问。
	Requests atomic.Int64
}

func (s *Stats) Record() int64 {
	// Add 返回递增后的值，适合顺便判断当前阈值。
	return s.Requests.Add(1)
}

func (s *Stats) Current() int64 {
	// Load 获取一个原子快照，不保证后续仍保持这个数值。
	return s.Requests.Load()
}

如果业务起点不是 0，可以在对象创建阶段调用 Store。初始化完成后，计数路径仍然应该统一使用原子方法，避免一部分代码通过普通赋值修改同一状态。

Go atomic.Int64 字段、Add 和 Load 之间的原子访问边界说明图 — 图1：atomic.Int64 字段边界说明图，展示计数状态只能通过原子方法进入和离开。

用 Add 记录并发事件，用 Load 读取当前值

Add(delta) 是记录事件的主路径。多个 goroutine 同时调用 Add(1) 时，每次增量都会参与原子更新；返回值是本次更新之后的结果，可以直接用于限流提示、批量刷新或采样。

func (s *Stats) RecordAndCheck(limit int64) bool {
	// 返回值属于本次递增后的状态，适合做一次性的边界判断。
	current := s.Requests.Add(1)
	return current >= limit
}

func (s *Stats) Snapshot() (int64, bool) {
	// 读取与判断使用同一个快照，避免同一函数里重复读取造成语义漂移。
	current := s.Requests.Load()
	return current, current > 0
}

需要注意，Load 只保证这次读取本身是原子的。它不能把“读取、判断、再修改”自动组合成一个不可分割的事务。例如“只有低于上限才加一”就不能仅靠 Load 加 Add 保证，需要根据业务改用 CAS 循环，或者把状态交给互斥锁保护。

Store、Add 与普通整数读写的选择

可以把几个操作的语义放在一起比较，减少因为方法名相近而产生的误用：

操作	作用	适合场景	注意点
`Add(1)`	在当前值上增量	请求数、完成数、重试次数	返回更新后的值
`Load()`	读取原子快照	展示指标、阈值判断	快照不会锁定后续变化
`Store(v)`	覆盖为指定值	重置窗口、加载初始值	会覆盖其他 goroutine 的累计结果