导入Foundation后Swift的String.contains行为差异原因及相关疑问

问题现象 #

未导入Foundation时，Swift标准库的String.contains(_:)行为：

"".contains("") // true
"a".contains("") // true
"a".contains("a") // true
"" == "" // true

导入Foundation后，行为发生变化：

import Foundation

"".contains("") // false
"a".contains("") // false
"a".contains("a") // true
"" == "" // true

核心原因 #

这是因为Swift标准库和Foundation框架对contains(_:)的实现逻辑不同，且导入Foundation后，编译器会优先选择Foundation提供的重载方法：

1. Swift标准库的String.contains(_:)遵循「序列包含」逻辑：空序列（空字符串）是任何序列的子序列，因此任何字符串调用contains("")都会返回true。
2. Foundation通过桥接NSString，给Swift String添加了同名的contains(_ str: String)方法，它继承自NSString的containsString:逻辑——NSString认为空字符串不是任何字符串的子串（包括空字符串本身），所以返回false。

编译器解析方法调用时，会优先匹配更具体的参数类型：Foundation的方法直接接受String类型参数，而标准库的方法接受符合Sequence且元素为Character的类型（String虽符合，但Foundation的重载匹配更直接），因此导入Foundation后会走Foundation的实现。

是否属于正常现象？ #

这是Swift的正常语言行为：

• Foundation作为Apple核心框架，会通过扩展给Swift原生类型（如String、Array）添加OC桥接行为，以此兼容OC生态。
• Swift允许扩展添加同名方法，编译器会按照重载解析规则选择合适的实现，目前语言本身不会对这类「优先级覆盖式重载」给出提示。
• 若要强制使用标准库的实现，可以通过类型约束明确指定：

  import Foundation
  
  // 强制调用Swift标准库的contains
  "a".contains("" as Sequence) // true
  

其他类似差异 #

这类差异大多来自Swift原生类型与OC Foundation类型的桥接，除了你提到的Array行为差异外，常见的还有：

• String.capitalized：标准库仅大写首字母，Foundation的实现会适配更多语言的词首大写规则
• Array.index(of:)：标准库与Foundation的匹配逻辑细节存在差异
• 数值类型转字符串：部分边缘场景下，标准库与Foundation的转换结果不同

目前没有官方的详尽差异清单，遇到此类问题时，可按住Command点击方法名，查看方法声明来源（Swift标准库/Foundation）来区分实现逻辑。

内容的提问来源于stack exchange，提问作者mingwei