maps.DeleteFunc 遍历删除是否安全

maps.DeleteFunc 遍历并删除同一个 map 是安全的，前提是删除发生在同一个 goroutine 内，回调只根据当前键和值返回是否删除。它不是先复制一份 map 再清理，而是利用 Go 对“遍历 map 时删除条目”的规定直接完成原地清理；因此可以放心删除匹配项，但不能依赖遍历顺序，也不要把回调写成一段复杂的并发更新逻辑。

官方资料：https://pkg.go.dev/maps

需要记住的边界是：删除当前遍历中的条目不会让程序因为迭代器失效而崩溃；尚未遍历到的条目如果被删除，后续不会再产生。但 map 的顺序未定义，回调里新增条目的结果也不应拿来构造确定性业务流程。

先把“安全”限定在单次原地清理

这个标题里的安全，首先指不会因为在遍历过程中删除 map 条目而破坏遍历。标准库实现的核心逻辑可以概括为：对 m 做 range，调用 del(k, v)，返回 true 时执行 delete(m, k)。所以它正是为“筛选后删除”这个任务准备的。

用纯谓词表达真正的删除条件

最稳妥的写法是让回调只完成一件事：读取 k 和 v，根据明确条件返回布尔值。下面的示例清理超过空闲阈值的会话，回调没有修改别的状态，调用结束后原 map 直接保留未过期记录。

package main

import (
	"fmt"
	"maps"
)

func main() {
	// 值表示分钟数；示例只保留仍在活跃窗口内的会话。
	sessions := map[string]int{
		"alice": 12,
		"bob":   47,
		"cindy": 5,
	}

	maps.DeleteFunc(sessions, func(user string, idleMinutes int) bool {
		// 谓词只读当前键值，返回 true 就删除这条会话。
		return idleMinutes >= 30
	})

	// map 的打印顺序不代表清理顺序，不能据此做业务判断。
	fmt.Println(sessions)
}

这里的 user 没有参与条件也没有问题；如果条件只看值，可以把参数写成下划线。真正需要避免的是在回调里顺手改写全局计数器、触发依赖 map 顺序的下一个动作，或者把另一个 map 的写入和当前清理绑定成隐含事务。

删除未到达条目可以，但顺序不能猜

Go 规范允许在 map 遍历期间删除元素：如果某个条目尚未到达就被删除，那么这次遍历不会再产生它。maps.DeleteFunc 正是利用了这条语义，因此不会出现“删除一个键后跳过数组下标”的切片式问题。

不过，map 的迭代顺序没有保证。假设回调第一次看到的是哪个用户、最后留下的键是什么，都不能写进业务规则。需要稳定结果时，先用 maps.Keys 收集键，再排序后按键处理；需要在同一轮里增加条目时，也不要期待新条目一定会被当前遍历访问。

package main

import (
	"maps"
	"slices"
)

func stableCleanup(m map[string]int) []string {
	// 先复制并排序键，避免把 map 的随机遍历顺序当成业务顺序。
	keys := slices.Sorted(maps.Keys(m))
	for _, key := range keys {
		if m[key] 

回调副作用和并发访问要单独处理

“可以边遍历边删除”不等于“回调里什么都能改”。如果回调还要给同一个 map 增加键，规范只保证新条目可能出现，也可能被跳过；如果回调依赖另一个共享结构，仍要保证那个结构的并发安全。更不能让一个 goroutine 调用 maps.DeleteFunc，另一个 goroutine 同时读写同一个普通 map，否则问题已经从遍历语义升级为数据竞争。

生产代码通常有三种选择：清理条件简单且无并发时直接用 maps.DeleteFunc；需要稳定日志或复杂副作用时先收集键、再统一删除；多个 goroutine 共享 map 时用互斥锁保护完整清理窗口，或者把写入集中到一个拥有 map 的 goroutine。锁只解决同步，不会替你定义回调里新增条目的业务顺序。

常见问题

maps.DeleteFunc 会按固定顺序调用回调吗？

不会。map 遍历顺序没有保证，回调被调用的先后不能用于排序、选主或生成稳定日志。

回调里再次 delete 其他键可以吗？

语言层面允许遍历期间删除，但会让判断和副作用耦合。若删除集合不是当前键值直接决定的，建议先收集键，再用第二阶段统一删除。

nil map 调用 maps.DeleteFunc 会 panic 吗？

不会。nil map 的遍历没有条目，删除操作也是空操作；但回调不会被调用，不能把它当作一次“发现过期项”的信号。

因此，maps.DeleteFunc 适合做局部、同步、按条件的原地清理。把谓词保持为只读判断，把顺序需求交给排序键列表，把并发需求交给锁或单线程所有权，安全边界就清楚了。