go 中对不存在的键调用 delete 是安全的,不会 panic 或报错;但对 nil map 调用会 panic。delete 无返回值、不判断存在性,存在性须用 v, ok := m[k] 判断。

Go 中对不存在的键调用 delete 是安全的
不会 panic,也不会报错,什么都不会发生 —— 这是 Go 语言明确保证的行为。你完全可以放心地对任意键调用 delete(m, key),哪怕 key 根本不在 m 里。
delete 的行为和常见误判场景
很多人以为 delete 会返回布尔值表示“删没删到”,其实它不返回任何值。所以没法靠返回值判断键是否存在;也不能靠它来“先检查再删除”——因为根本不需要检查。
- 误判现象:
if delete(m, k) { ... }编译失败,delete没有返回值 - 真实使用场景:清理缓存、批量剔除已过期条目、实现类似“软删除”的逻辑
- 性能影响:无论键是否存在,
delete都是 O(1) 平均时间复杂度,无额外开销
想确认键是否存在?得用 map 访问语法,不是 delete
delete 只负责删,不负责查。要判断键是否存在,必须用双变量赋值形式:v, ok := m[k]。
- 错误写法:
if m[k] != nil { delete(m, k) }—— 对非指针/非接口类型(如int)会误判,因为零值不是nil - 正确写法:
if _, ok := m[k]; ok { delete(m, k) },但其实没必要,直接delete(m, k)更简洁 - 注意:
ok是唯一可靠的“存在性”信号,v的值可能为零值,不能用来判断
map 为 nil 时调用 delete 会怎样?
会 panic,错误信息是 panic: assignment to entry in nil map —— 别被名字误导,delete 也属于“写操作”,对 nil map 不安全。
立即学习“go语言免费学习笔记(深入)”;
- 典型错误:声明了
var m map[string]int但没make就直接delete(m, "x") - 修复方式:确保 map 已初始化,例如
m := make(map[string]int) - 兼容性提醒:该 panic 在所有 Go 版本中行为一致,无例外
delete 设计就是“只管删、不问在不在”,真正的边界风险只在 nil map,而不是键不存在。别给它加戏,也别替它操心存在性。










