NSAttributedString的Emoji兼容问题：字距/段落样式致Emoji不显示

我之前也碰到过类似的Emoji显示bug，大概率不是kerning或者段落样式的直接问题，而是Unicode编码处理、字体支持这类容易忽略的细节导致的，咱们一步步排查：

1. 先确认字符串的Unicode编码完整性 #

很多复杂Emoji（比如带肤色修饰的人物Emoji、组合Emoji）是由多个Unicode码点拼接而成的，用户生成的字符串如果在传输或处理过程中被意外拆分、截断，就会导致渲染失败。

比如👨🏿‍💻这个Emoji，实际是由4个码点组成：U+1F468（👨）、U+1F3FF（🏿）、U+200D（零宽连接符）、U+1F4BB（💻）。如果中间的零宽连接符丢失，就会变成👨🏿💻三个独立字符，甚至部分码点无法识别。

你可以用这段代码打印字符串的所有Unicode码点，检查是否完整：

print("Unicode Scalars: \(myString.unicodeScalars.map { "U+\(String($0.value, radix: 16).uppercased())" })")

2. 检查字体是否支持目标Emoji #

如果你的UILabel用了自定义字体，很可能这个字体没有包含Emoji的字形。虽然系统默认会自动 fallback 到苹果的Emoji字体，但有些自定义字体的配置会干扰这个 fallback 逻辑。

快速验证方法：临时把UILabel的字体改成系统默认字体，看看Emoji是否能正常显示：

myLabel.font = UIFont.systemFont(ofSize: 17)
myLabel.text = problematicString

如果能显示，说明是自定义字体的问题。解决办法是用UIFontDescriptor组合字体，让普通文本用自定义字体，Emoji自动使用系统支持的字体：

// 自定义字体
guard let customFont = UIFont(name: "YourCustomFontName", size: 17) else { return }
// 创建支持Emoji fallback的字体描述符
let emojiDescriptor = customFont.fontDescriptor.addingAttributes([
    UIFontDescriptor.AttributeName.family: customFont.familyName
]).withSymbolicTraits(.traitEmoji) ?? customFont.fontDescriptor
let emojiFallbackFont = UIFont(descriptor: emojiDescriptor, size: 17)

// 应用到富文本
let attrString = NSAttributedString(string: yourString, attributes: [
    .font: emojiFallbackFont,
    .kern: 1.0 // 你的字距设置
])
myLabel.attributedText = attrString

3. 过滤字符串中的隐藏控制字符 #

用户输入的字符串可能包含看不见的控制字符（比如零宽空格、无效的换行符、非打印字符），这些字符可能干扰Emoji的渲染逻辑。

可以用正则表达式过滤掉这些无效字符：

// 移除所有非打印的控制字符
let cleanedString = problematicString.replacingOccurrences(
    of: "\\p{C}", 
    with: "", 
    options: .regularExpression
)

4. 排查富文本属性的冲突 #

即使你注释了kerning，可能还有其他富文本属性（比如baselineOffset、strikethroughStyle、foregroundColor的特殊设置）间接影响渲染。

最简验证方法：创建一个完全基础的富文本，只保留文本和默认字体，看看Emoji是否正常：

let testAttr = NSAttributedString(
    string: problematicString,
    attributes: [.font: UIFont.systemFont(ofSize: 17)]
)
myLabel.attributedText = testAttr

如果这个基础版本能显示Emoji，再逐个添加你需要的属性（比如kerning、段落样式），就能定位到哪个属性导致的冲突。

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