当前位置:首页 > 文章列表 > Golang > Go教程 > Go slices.Contains 怎样判断切片是否包含指定值

Go slices.Contains 怎样判断切片是否包含指定值

来源:17golang原创 2026-11-16 10:41:23 0浏览 收藏

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。

切片、目标值和 slices.Contains 返回结果的静态关系说明图
图1:切片成员判断的输入与结果关系说明图;这是静态说明图,不是运行截图。

用 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 把“什么算匹配”交给回调。后者适合结构体按字段匹配、字符串忽略大小写或需要做规范化之后再比较的情况。

slices.Contains 与 slices.ContainsFunc 适用边界的静态对比图
图2: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。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go sync.WaitGroup.Go 怎样管理一次异步任务Go sync.WaitGroup.Go 怎样管理一次异步任务
上一篇
Go sync.WaitGroup.Go 怎样管理一次异步任务
Go Request.WriteProxy 怎样写出代理格式的 HTTP 请求
下一篇
Go Request.WriteProxy 怎样写出代理格式的 HTTP 请求
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1048次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1045次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1206次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1151次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    995次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码