为何会出现appendInterpolation的歧义使用问题？

问题背景 #

当使用遵循CustomStringConvertible协议的结构体时，常规String插值可以正常输出其description内容，但SwiftUI的Text组件采用的是LocalizedString插值逻辑，无法直接适配这类结构体——必须手动添加.description，或者通过Text(verbatim: ...)、Text(String(describing: ...))的方式才能正常显示。

为了让Text("\(实例)")的写法直接生效，有人尝试扩展LocalizedStringKey.StringInterpolation：

extension LocalizedStringKey.StringInterpolation {
   public mutating func appendInterpolation<S: CustomStringConvertible>(_ convertible: S) {
      self.appendInterpolation(convertible.description)
   }
}

这个扩展确实能让Text("\(car)")（其中Car结构体遵循CustomStringConvertible）正常输出description，但副作用是：普通数值类型的插值（比如Text("\(a)")，a为Int类型）会触发**“Ambiguous use of appendInterpolation”**错误，移除扩展后错误消失。

原因说明 #

问题出在Swift的方法重载匹配逻辑上：

• Int等Swift基础数值类型本身就遵循CustomStringConvertible协议，所以你的扩展重载会被编译器纳入候选调用列表。
• 系统本身已经为数值类型提供了专门的appendInterpolation重载，用于处理本地化场景下的数字格式（比如不同地区的千位分隔符、小数点样式）。
• 当插值Int类型时，编译器同时匹配到系统的数值专用重载和你添加的CustomStringConvertible通用重载，无法确定优先调用哪一个，因此抛出歧义错误。

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