strings.Contains 是 Go 中判断子串存在的首选函数,语义清晰、性能良好,但仅支持精确匹配、区分大小写,需手动处理大小写转换和前缀/后缀场景。

strings.Contains 是最直接的子串判断方式
strings.Contains 是 Go 标准库中判断子串存在的首选函数,它返回 bool,语义清晰、性能良好,且不区分大小写(需手动处理)。它底层使用朴素匹配,在大多数日常场景下足够快,无需额外引入第三方包。
常见错误是误以为它支持通配符或正则——它只做精确子串匹配,不支持模糊或模式匹配。
- 参数顺序固定:
strings.Contains(s, substr),第一个是主字符串,第二个是待查子串 - 空字符串
""会被认为存在于任意字符串中(包括空串),即strings.Contains("hello", "")返回true - 如果
substr为nil或未初始化的字符串变量,会 panic(但 Go 中字符串字面量和零值都是有效空串,一般不会触发)
大小写不敏感的子串判断要自己处理
strings.Contains 本身区分大小写。若需忽略大小写(比如搜索用户输入的关键词),必须先统一转为同一大小写再判断。推荐用 strings.ToLower,而非 strings.ToUpper,因某些 Unicode 字符在大写转换时行为更复杂。
注意:对非 ASCII 字符(如带重音符号的法语、中文等),strings.ToLower 是安全的;但若涉及土耳其语等特殊 locale 规则,应使用 golang.org/x/text/cases 包。
立即学习“go语言免费学习笔记(深入)”;
import "strings" s := "Hello World" substr := "HELLO" found := strings.Contains(strings.ToLower(s), strings.ToLower(substr)) // true
需要前缀/后缀匹配时别硬套 Contains
如果实际需求是“是否以某字符串开头”或“是否以某字符串结尾”,应直接用 strings.HasPrefix 或 strings.HasSuffix。它们语义更明确、性能略优(避免完整扫描),且逻辑上更不易出错。
-
strings.Contains("https://example.com", "http")虽然能工作,但无法区分http是协议还是路径中的一部分 - 正确做法:
strings.HasPrefix(url, "https://")更精准,也更易读 - 若混合使用,容易在边界 case 上出问题,例如
strings.Contains("cat", "at")和strings.HasSuffix("cat", "at")结果相同,但意图完全不同
性能敏感场景下注意切片开销
当主字符串非常大(如几十 MB 的日志内容),而子串极短时,strings.Contains 仍会逐字节扫描。此时若已知子串位置大致靠前,可考虑用 strings.Index 配合 != -1 判断——两者底层实现一致,但 Index 多返回一个整数,无额外开销。
真正影响性能的不是函数选型,而是是否在循环中反复调用 strings.ToLower 转换大字符串。应尽量避免在热路径中对长字符串做重复转换。
s := veryLongString()
lowerS := strings.ToLower(s) // 提前转一次
for _, keyword := range keywords {
if strings.Contains(lowerS, strings.ToLower(keyword)) {
// ...
}
}
Go 的字符串是不可变的,每次 ToLower 都会分配新内存。如果只是判断存在性且不关心位置,strings.Contains 已是最简方案;但一旦涉及大小写、边界语义或高频调用,细节就容易被忽略。










