Go reflect.Value.Clear 对 map 和 slice 的效果有什么不同

reflect.Value.Clear 对 map 和 slice 的效果并不相同：对 map，它会删除全部键值条目，使 len 变为 0；对 slice，它只把当前长度范围内的元素改成元素类型的零值，slice 的 len 和 cap 都不变。两种操作都不会把变量本身改成 nil。

这个方法从 Go 1.21 开始提供，对应语言内置的 clear。官方文档地址：https://pkg.go.dev/reflect#Value.Clear。它适合反射框架在运行时只知道容器 Kind、却不知道具体 map 或 slice 类型的场景；普通业务代码类型明确时，直接用内置 clear 更简单。

最直接的区别：map 删除条目，slice 保留形状

先看一个同时处理 map 和 slice 的最小示例。这里特意打印清理前后的长度和容量，用来区分“容器变空”与“元素变成零值”。

package main

import (
    "fmt"
    "reflect"
)

func main() {
    scores := map[string]int{"alice": 91, "bob": 86}
    values := []int{7, 8, 9}

    // Clear 接受 Kind 为 Map 或 Slice 的 reflect.Value。
    reflect.ValueOf(scores).Clear()
    reflect.ValueOf(values).Clear()

    // map 的条目被删除；slice 的长度和容量保持不变。
    fmt.Printf("map=%v len=%d nil=%t\n", scores, len(scores), scores == nil)
    fmt.Printf("slice=%v len=%d cap=%d nil=%t\n", values, len(values), cap(values), values == nil)
}

这段代码的结果要这样理解：

因此，判断 slice 是否“清空”时不能只看元素内容。如果调用后仍然有 len(s) == 3，遍历会得到三个零值；如果业务真正需要零长度，还要调整 slice header，例如直接写 s = s[:0]。两者目的不同：Clear 清元素，重切片改长度。

slice 只清当前长度，不清整个容量

slice 持有长度、容量和底层数组引用。Value.Clear 只处理索引区间 [0, len(s))，不会自动把容量范围内暂时看不见的元素全部归零。下面的例子先缩短视图，再清理当前视图：

package main

import (
    "fmt"
    "reflect"
)

func main() {
    backing := []int{10, 20, 30, 40}
    view := backing[:2]

    // 只清理 view 当前长度覆盖的前两个元素。
    reflect.ValueOf(view).Clear()

    // backing 与 view 共享底层数组，所以前两个位置都能看到零值。
    fmt.Println("view:", view)
    fmt.Println("backing:", backing)
}

这里 view 的长度是 2，所以只有 backing[0] 和 backing[1] 被改为 0，后面的 30、40 不受影响。只要其他 slice 与它重叠并共享底层数组，那些别名就会观察到相同的元素变化。

对于 []*T、[]map[K]V、[]chan T 或接口 slice，元素零值是 nil。清零这些位置可以移除底层数组中的旧引用，但这不等于立刻释放底层数组：slice 自身仍然保留原长度、容量和数组引用，实际回收仍由可达性与垃圾回收决定。

map 清掉条目后仍然是可用 map

map 分支更接近逐项调用 delete 的最终效果：所有条目消失，len(m) 变为 0，但非 nil map 仍然是已经初始化的 map，后续可以继续插入。

package main

import (
    "fmt"
    "reflect"
)

func main() {
    cache := map[string]string{"token": "ready"}
    alias := cache

    // 清理的是同一个 map 对象，所有别名都会看到条目消失。
    reflect.ValueOf(cache).Clear()
    alias["next"] = "ok"

    // cache 与 alias 仍引用同一个可写 map。
    fmt.Println(cache, alias, len(cache))
}

cache 与 alias 指向同一个 map，因此 Clear 后两边都看到空 map，随后通过 alias 写入的条目也会从 cache 看到。不要把它理解为 cache = nil：后者只会改变当前变量，其他别名仍可访问原 map，而且对 nil map 写入会 panic。

容易忽略的边界：别名、nil 与 CanSet

1. nil map 和 nil slice 都是无操作

Go 语言规范规定，内置 clear 遇到 nil map 或 nil slice 时不做任何事；reflect.Value.Clear 对代表这两种容器的 Value 同样不会产生数据变化。需要注意的是，“代表 nil 容器的有效 Value”和“零 reflect.Value”不是一回事。前者的 Kind 仍是 Map 或 Slice，后者 Kind 为 Invalid，调用 Clear 会 panic。

2. 非 Map、非 Slice 会 panic

官方文档明确规定，Value 的 Kind 不是 Map 或 Slice 时，Clear 会 panic。框架接收 any 时应先检查有效性和 Kind，而不是拿到 Value 就调用。

func clearContainer(x any) bool {
    v := reflect.ValueOf(x)

    // 先排除无效 Value，再限制允许的容器 Kind。
    if !v.IsValid() {
        return false
    }
    if v.Kind() != reflect.Map && v.Kind() != reflect.Slice {
        return false
    }

    // nil map 或 nil slice 调用后保持 nil，不需要额外分支。
    v.Clear()
    return true
}

3. Clear 不等同于给变量赋新值

reflect.ValueOf(scores).CanSet() 通常是 false，因为这里拿到的不是可赋值变量本身；但 Clear 操作的是 map 指向的条目或 slice 指向的元素，官方对 Clear 的限制是 Kind 必须为 Map 或 Slice，并没有要求 CanSet 为 true。这与 Set、SetLen 等修改 Value 本身的操作不同。

不过，若你的目标是把调用方变量改成 nil、替换成新 map，或者改变 slice 长度，就必须取得可设置的变量 Value，通常需要传入指针并调用 Elem()。不要因为 Clear 能在 CanSet()==false 时工作，就把它当成所有反射修改都不需要地址性的证明。

和内置 clear 相比，什么时候值得用反射

Go 1.21 同时提供内置 clear 与 reflect.Value.Clear，两者对 map、slice 和 nil 容器的核心语义一致。选择标准主要是类型信息在哪里：

• 代码已经知道具体类型时，优先写 clear(m) 或 clear(s)，类型检查更直接，也更容易阅读。
• 序列化框架、对象池、通用清理器只在运行时拿到 reflect.Value 时，使用 Value.Clear 可以避免按具体类型分派。
• 如果还需要把 slice 长度改成 0，Clear 不是完整方案；要根据调用契约决定是否额外使用 SetLen(0)。
• 如果输入可能是数组、字符串或结构体，必须先检查 Kind，因为 Clear 不支持这些类型。

最稳妥的记忆方式是：map 的“内容”是键值条目，Clear 后条目数量归零；slice 的“内容”是当前长度区间内的元素，Clear 后元素归零但容器形状不变。只要把数据与 slice header 分开看，这个 API 就不容易用错。

常见问题

Value.Clear 会把 slice 的 len 变成 0 吗？

不会。它只把索引 0 到 len(s)-1 的元素设为零值，长度和容量都保持不变。

Value.Clear 会释放 map 或 slice 的内存吗？

不能据此保证立即释放。map 条目会被删除，slice 元素中的引用可被清除，但容器本身及 slice 的底层数组是否回收仍取决于后续引用和垃圾回收。

数组可以调用 Value.Clear 吗？

不可以。官方 API 只接受 Kind 为 Map 或 Slice 的 Value；数组、字符串、结构体及零 Value 都会触发 panic。

Go 1.20 能使用 Value.Clear 吗？

不能。这个方法在 Go 1.21 加入。需要兼容更早版本时，map 可以遍历键并调用 SetMapIndex(key, reflect.Value{}) 删除，slice 可以遍历索引并把元素设为对应零值。