Go sync.Map.Clear 怎样快速清空临时索引

如果程序使用 sync.Map 保存一批可以整体失效的临时索引，Go 1.23 及以后可以直接调用 Clear 删除全部条目。它适合“这一代索引整体作废，再由后续请求逐步填充”的场景；如果只是删除一个键，仍然用 Delete，如果数据本来就由单个 goroutine 管理，普通 map 通常更简单。

官方文档：https://pkg.go.dev/sync#Map.Clear

消息是什么：Clear 是 Go 1.23 新增的整体清空入口

Go 1.23 的 sync.Map 增加了 Clear 方法。官方定义很直接：调用后删除全部条目，得到一个空的 Map。零值 sync.Map 可以直接使用，但首次使用后不能复制，所以应把它作为结构体字段或通过指针传递，而不是在函数之间按值复制。

这里的“空”指当前映射不再保留原有键值，不代表业务上的新索引已经构建完成。清空后如果有请求继续写入，新的键仍可能马上出现，因此它更像一次整体失效动作，不是暂停所有并发写入的全局栅栏。

适用场景：让临时索引按代际整体失效

典型例子是配置快照、短期去重表、路由辅助索引或定期刷新缓存：旧数据可以一起淘汰，新数据由后续请求按需写回。把这类容器包一层方法，能把“索引重置”表达成业务动作，调用方不用知道底层是 sync.Map 还是其他实现。

不要把 Clear 当成事务提交。若清空期间还有 goroutine 执行 Store，清空后的容器可能再次出现新条目；如果业务要求切换前后读到严格一致的快照，还需要额外的版本号、指针交换或锁协议。

快速试用：把 Store、Load 和 Clear 封装成重置动作

package main

import (
	"fmt"
	"sync"
)

// TempIndex 只保存可整体失效的临时键值。
type TempIndex struct {
	data sync.Map
}

func (idx *TempIndex) Put(key, value string) {
	// Store 写入一条索引，sync.Map 适合多 goroutine 读写的特定场景。
	idx.data.Store(key, value)
}

func (idx *TempIndex) Reset() {
	// Clear 删除当前全部条目，但不会阻止后续新的 Store。
	idx.data.Clear()
}

func (idx *TempIndex) Get(key string) (string, bool) {
	// Load 的结果要先检查 ok，再做类型断言。
	value, ok := idx.data.Load(key)
	if !ok {
		return "", false
	}
	text, ok := value.(string)
	return text, ok
}

func main() {
	var index TempIndex
	index.Put("user:42", "v1")
	index.Reset()
	value, ok := index.Get("user:42")
	fmt.Println(value, ok) // 示例语义：清空后旧键不再命中。
}

这个封装的关键不在于把 Clear 改名，而在于限制它的职责：Reset 只表示旧索引整体失效，真正的新索引何时写回由上层流程决定。若 value 不是字符串，应按实际类型定义返回值，避免把类型断言失败误认为清空失败。

和逐项 Delete、普通 map clear 有什么区别

Delete 适合知道具体键的定点删除；Clear 适合整批失效；内置 clear(m) 适合普通 map，但普通 map 的并发读写仍需要由锁或单 goroutine 组织。三者不要仅按“哪一个更快”选择，而要看数据的所有权和失效范围。

采用前要留意的三个风险

1. 版本：如果模块需要兼容 Go 1.22 或更早版本，不能直接调用 Clear；应在升级策略中明确最低工具链。
2. 并发重建：清空动作与后续 Store 可能交错。需要严格快照时，为数据增加代际标记，或用不可变快照指针切换。
3. 容器选择：sync.Map 不是普通 map 的通用替代品。若访问模式是单线程、强类型、需要遍历和事务式更新，带锁的普通 map 往往更容易维护。

常见问题

Clear 后马上 Load 旧键一定返回未找到吗？

对已经完成清空且期间没有新写入的简单场景，旧键不会再命中；如果其他 goroutine 同时重新写入同一个键，就要按你的并发协议判断它属于哪一代数据。

可以用 Clear 代替逐个 Delete 吗？

只有在业务确实允许整张临时索引一起失效时才可以。只撤销单个用户、单个租户或单个任务时，应保留更小的删除范围。

总结：Go 1.23 起，sync.Map.Clear 为并发临时索引提供了清晰的整体重置入口；它解决的是“全部失效”的表达问题，不替代单键删除，也不替代普通 map 的并发设计。