Go maps.DeleteFunc 如何按条件清理 map

如果要按条件批量清理 Go map，直接调用 maps.DeleteFunc：回调函数对某个键值对返回 true，这一项就会从原 map 中删除；返回 false，这一项保留。它没有返回值，也不会生成一个新 map，所以清理前要确认传入的 map 可以被原地修改。

先确认 maps.DeleteFunc 删除的到底是什么

maps.DeleteFunc 属于标准库 maps 包，函数签名可以简化理解为：

func DeleteFunc[M ~map[K]V, K comparable, V any](m M, del func(K, V) bool)

它遍历 m 中的键和值，把它们交给 del 判断。回调返回 true 时删除当前键；返回 false 时什么也不做。函数本身不返回删除数量、剩余 map 或错误，因此如果业务需要统计删除项，应在回调外准备计数器。

这个 API 和 clear(m) 不是一回事：clear 表示清空全部元素，而 DeleteFunc 把“是否删除”的决定交给条件函数。标准库 maps 包在 Go 1.21 加入，老项目若模块版本或工具链低于这个能力，需要先确认升级条件。

把条件判断放进 del 回调

我更愿意先把删除条件写成一句完整的话，再翻译成回调。比如缓存里只保留仍处于 active 状态的会话，其余状态都清理掉：

package main

import (
    "fmt"
    "maps"
)

type Session struct {
    State string
    Hits  int
}

func main() {
    sessions := map[string]Session{
        "u-101": {State: "active", Hits: 8},
        "u-102": {State: "expired", Hits: 2},
        "u-103": {State: "blocked", Hits: 1},
    }

    // 返回 true 才删除；这里保留 active，清理其他状态。
    maps.DeleteFunc(sessions, func(key string, value Session) bool {
        // key 可用于按租户或前缀补充条件，当前示例只判断状态。
        return value.State != "active"
    })

    // DeleteFunc 原地修改 sessions，调用后直接读取同一个 map。
    fmt.Println(len(sessions), sessions["u-101"].State)
}

这段示例的关键不是回调写成匿名函数，而是删除条件和业务规则一一对应：State != "active" 为真时，u-102 与 u-103 会被删除，u-101 保留。回调里的 key 暂时没有参与判断，但保留它能提醒我们：条件既可以看值，也可以同时看键和值。

清理后如何核对保留项

DeleteFunc 没有结果返回，核对动作要回到原 map。最实用的检查通常是三件事：看剩余数量、查询一个应该保留的键、查询一个应该被删除的键。查询被删除的键时，不能只读取零值，要使用带 ok 的形式区分“键不存在”和“值刚好是零值”。

// 用 ok 区分键不存在，避免把零值误判为仍然保留。
kept, ok := sessions["u-101"]
if !ok || kept.State != "active" {
    panic("active session should be kept")
}

// 被删除的键不应再出现在 map 中。
if _, ok := sessions["u-102"]; ok {
    panic("expired session should be deleted")
}

这里的判断是在验证业务规则，不是在验证 map 的遍历顺序。Go map 的迭代顺序不稳定，不能因为某次打印结果把 u-101 放在第一位，就把顺序当成清理成功的证据。若需要排序后的展示结果，清理完成后另取 keys，再排序输出。

nil map、空 map 和全部删除要分开看

maps.DeleteFunc(nil, del) 可以安全完成遍历，因为 nil map 没有元素；它不会被初始化，也不会因为调用而变成可写 map。空但非 nil 的 map 同样没有可删除项。两者如果要继续写入，仍然需要先 make。

另一个常见误区是把“按条件删除”写成“为了安全先复制一份”。DeleteFunc 的目标就是原地修改。如果后续还要使用完整快照，可以先用 maps.Clone 复制，再对副本执行清理；如果只想得到满足条件的新 map，也可以遍历原 map，把保留项写入新 map。不要在回调里额外修改同一个 map 的其他键，条件函数应尽量保持简单、可重复判断。

常见问题

maps.DeleteFunc 会返回删除了多少项吗？

不会。它没有返回值；需要统计时，在回调返回 true 的分支对应地增加计数。

回调里应该返回“保留条件”还是“删除条件”？

返回删除条件。最容易读懂的写法是“满足清理规则就返回 true”，例如 value.State == "expired"。

能不能在遍历时依赖 map 的输出顺序？

不能。删除结果只由回调条件决定，map 的迭代顺序不应参与业务判断；需要稳定顺序时，清理后单独提取并排序键。