Go slices.Contains 怎样判断切片是否包含指定值
来源:17golang原创
时间:2026-11-16 10:41:23 178浏览 收藏
slices.Contains 用来回答一个明确的问题:目标值是否等于切片中的某个元素。对字符串、整数以及其他满足 comparable 约束的类型,可以直接传入切片和目标值;找到元素返回 true,遍历结束仍未找到返回 false。如果比较规则不是 Go 的 == 能表达的形式,则切换到 slices.ContainsFunc。
官方资料:https://pkg.go.dev/slices#Contains
slices.Contains(s, v)判断的是元素相等,不是模糊匹配、排序或去重。- 空切片没有元素,因此结果是
false;它不会返回错误。 - 元素不满足
comparable,或需要按字段、大小写等规则比较时,使用slices.ContainsFunc。
先看 Contains 的输入和结果
可以把调用关系理解成三个对象:切片 s 提供候选元素,目标值 v 提供比较对象,slices.Contains 最后返回一个 bool。它只关心是否存在至少一个相等元素,不会告诉你元素下标;需要下标时可以考虑 slices.Index。

用 Contains 判断可比较元素
字符串和整数都属于常见的可比较元素。下面的例子把成员判断封装成一个小函数,并分别展示命中、未命中和空切片三种结果:
package main
import (
"fmt"
"slices"
)
func containsRole(roles []string, wanted string) bool {
// Contains 只回答是否存在相等元素,不改变原切片。
return slices.Contains(roles, wanted)
}
func main() {
roles := []string{"reader", "editor"}
fmt.Println(containsRole(roles, "editor")) // 命中目标元素。
fmt.Println(containsRole(roles, "owner")) // 没有相等元素时返回 false。
fmt.Println(slices.Contains([]int(nil), 1)) // nil 切片没有元素,结果仍是 false。
}
这个函数没有修改 roles,也不会因为空切片而产生异常。对于权限、状态、白名单或允许的格式列表等场景,直接把返回值放进条件表达式即可。
空切片和元素类型有哪些边界
空切片与 nil 切片都不包含任何元素,所以 slices.Contains 返回 false。它没有错误返回值,调用方只需要决定“未命中”是否意味着拒绝、跳过或使用默认分支。
类型约束是另一个边界。Contains 的元素类型需要满足 comparable,因此整数、字符串、指针和字段全部可比较的结构体可以直接使用;包含切片、映射或函数字段的类型不能直接用 == 比较,也就不能直接传给这个函数。
package main
import (
"fmt"
"slices"
)
type User struct {
ID int
Name string
}
func main() {
users := []User{{ID: 7, Name: "Lin"}, {ID: 9, Name: "Ming"}}
wanted := User{ID: 9, Name: "Ming"}
// User 的字段都可比较,因此可以直接使用 Contains。
fmt.Println(slices.Contains(users, wanted))
}
结构体的直接判断要求所有字段都相等。如果业务只看 ID,或需要忽略名称大小写,就不要为了调用 Contains 去改写数据模型。
Contains 与 ContainsFunc 怎么选择
这两个函数解决的是相邻但不同的问题:Contains 使用元素自身的相等关系,ContainsFunc 把“什么算匹配”交给回调。后者适合结构体按字段匹配、字符串忽略大小写或需要做规范化之后再比较的情况。

package main
import (
"fmt"
"slices"
"strings"
)
type User struct {
ID int
Name string
}
func main() {
users := []User{{ID: 7, Name: "Lin"}, {ID: 9, Name: "Ming"}}
// 只按 ID 匹配时,用回调表达业务规则,而不是要求整个结构体相等。
hasID := slices.ContainsFunc(users, func(item User) bool {
return item.ID == 9
})
fmt.Println(hasID)
names := []string{"Alice", "Bob"}
// 忽略大小写属于自定义比较,ContainsFunc 比先复制数据更直接。
hasBob := slices.ContainsFunc(names, func(item string) bool {
return strings.EqualFold(item, "bob")
})
fmt.Println(hasBob)
}
| 需求 | 推荐 API | 原因 |
|---|---|---|
元素能直接用 == 比较 | slices.Contains | 调用短,意图清楚 |
| 按结构体某个字段匹配 | slices.ContainsFunc | 把字段规则写在回调中 |
| 忽略大小写或先规范化 | slices.ContainsFunc | 相等关系需要额外逻辑 |
| 需要元素下标 | slices.Index 或对应的 Func 版本 | Contains 只返回 bool |
封装成员判断时避免三个误区
第一,不要把 Contains 当成去重函数。它只读取切片并返回判断结果,不会删除重复项。第二,不要把未命中当成系统错误;空切片返回 false 是正常语义,业务是否报错由调用方决定。第三,不要为了追求一行代码,把复杂匹配规则塞进一次转换或临时复制中。
package main
import (
"fmt"
"slices"
)
func requireStatus(statuses []string, wanted string) error {
// 先表达成员判断,再由业务层决定未命中的错误信息。
if !slices.Contains(statuses, wanted) {
return fmt.Errorf("status %q is not allowed", wanted)
}
return nil
}
这样的边界让调用方更容易替换策略:简单值继续用 Contains,字段或规范化规则改用 ContainsFunc,需要位置则使用索引函数。不要用一个 API 同时承担成员判断、排序、去重和错误策略。
常见问题
nil 切片调用 Contains 会 panic 吗?
不会。nil 切片没有元素,结果是 false。
Contains 能判断结构体吗?
可以,但结构体必须整体可比较,且要求所有字段都相等。只按某个字段匹配时使用 ContainsFunc。
Contains 能忽略字符串大小写吗?
不能直接忽略。大小写不敏感属于自定义规则,应使用 slices.ContainsFunc 配合 strings.EqualFold。
想知道元素在哪个位置怎么办?
使用 slices.Index,或者使用对应的索引回调函数;Contains 本身只返回布尔值。
一句话总结:能用元素相等关系表达的问题就用 slices.Contains;空切片自然得到 false;一旦比较规则涉及字段、大小写或规范化,就切换到 slices.ContainsFunc。
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习