Swift下自定义字体显示0xFF01~0xFF71字符仅模拟器生效如何解决

核心原因 #

• iOS真机和模拟器的字体渲染底层逻辑存在差异：模拟器运行在macOS架构上，字体解析和缺失字形fallback逻辑继承自macOS，当自定义字体无对应码点字形时，会自动调用系统支持该字符的字体替换渲染，你在模拟器看到的正常字符实际不是自定义字体的内容。而iOS真机的fallback规则更严格，当自定义字体没有对应码点的字形时，会直接渲染字体内置的.notdef占位符，大部分字体的.notdef就是P、D、方框问号这类异常字符。
• 字体cmap表兼容性问题：很多旧字体或者非专业工具生成的自定义字体，仅包含macOS平台识别的cmap（字符编码映射表）子表，没有iOS要求的平台ID为3的Unicode编码子表，模拟器能识别macOS格式的cmap找到对应字形，真机找不到映射关系，就会返回.notdef占位符。
• 额外可能的配置问题：模拟器的文件系统默认大小写不敏感，真机是大小写敏感，如果你的字体文件名、Info.plist中配置的字体名大小写不匹配，即使侥幸加载到字体，也可能出现部分字符映射异常。

解决方案 #

第一步：确认字体字形完整性 #

用Mac自带的「字体册」打开你的自定义字体文件，点击顶部菜单「显示」→「字形」，搜索对应Unicode码（比如FF01），确认0xFF01到0xFF71区间的字形确实存在于字体文件中。如果不存在，需要替换字体或者补全对应字形。

第二步：修复字体cmap表兼容性 #

用otfinfo命令行工具检查字体的cmap配置，打开终端执行：

otfinfo -c 你的字体文件路径

确认输出中存在platformID: 3, encodingID: 1（Unicode BMP）或者platformID: 3, encodingID: 10（Unicode全平面）的条目，如果没有，使用字体编辑工具（比如FontForge）打开字体，导出时勾选保留Windows平台Unicode cmap表即可。

第三步：改用CoreText强制渲染指定字体字形 #

UIKit的draw(at:withAttributes:)会自动触发系统字体回退，改用CoreText直接读取字体的glyph渲染，完全跳过系统回退逻辑，示例代码如下：

ch = 0xFF01
currentFont = UIFont(name: String(cString: fontNamePtr), size:CGFloat(fntSize))! 
guard let context = UIGraphicsGetCurrentContext() else { return }

var uniChar = UniChar(ch)
var glyph: CGGlyph = 0
// 直接从自定义字体取对应字符的glyph
let glyphExists = CTFontGetGlyphsForCharacters(currentFont as CTFont, &uniChar, &glyph, 1)

if glyphExists, glyph != 0, let glyphPath = CTFontCreatePathForGlyph(currentFont as CTFont, glyph, nil) {
    context.saveGState()
    // 调整坐标适配UIKit坐标系
    context.translateBy(x: CGFloat(x), y: CGFloat(y))
    context.setFillColor(UIColor.black.cgColor) // 根据需要调整颜色
    context.addPath(glyphPath)
    context.fillPath()
    context.restoreGState()
} else {
    // 自定义字形缺失的 fallback 逻辑
}

第四步：排查资源配置问题 #

1. 检查Build Phases→Copy Bundle Resources中是否包含你的字体文件，没有的话手动添加。
2. 确认Info.plist中Fonts provided by application项下的字体文件名，和实际文件的名称、后缀、大小写完全一致。

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