Swift 4/Xcode：数组/结构体字符串值无法显示到CATextLayer()的问题

我之前也踩过CATextLayer不显示内容的坑，结合你说的「数据已传递但图层空白」的情况，咱们可以从这几个常见排查点入手：

1. 先确认CATextLayer的核心属性是否配置完整 #

很多时候空白不是数据没传过来，而是基础属性没设对：

• 字符串解包问题：如果你的结构体里的字符串是可选类型String?，赋值时一定要确保解包（比如用textLayer.string = message.text!或者可选绑定），虽然print能输出，但可选值直接赋值给string可能会被忽略。
• 字体与颜色：如果没设置font、fontSize，或者foregroundColor和背景色一致，文本就会"隐身"。比如：

  textLayer.font = UIFont.systemFont(ofSize: 14)
  textLayer.foregroundColor = UIColor.black.cgColor
  textLayer.fontSize = 14
  

• 对齐与可视范围：设置alignmentMode（比如.center）避免文本超出图层边界，同时可以给图层加个临时背景色（比如textLayer.backgroundColor = UIColor.red.cgColor），确认图层本身是在可视区域的。

2. 检查图层的frame/bounds和contentsScale #

这是最容易被忽略的点：

• 如果你把CATextLayer贴在SCNBox上，要确保图层的尺寸和Box的面完全匹配，比如：

  let box = SCNBox(width: 150, height: 80, length: 10, chamferRadius: 0)
  textLayer.frame = CGRect(x: 0, y: 0, width: box.width, height: box.height)
  

• 必须设置contentsScale：在Retina屏幕上，如果不设置textLayer.contentsScale = UIScreen.main.scale，文本可能会因为分辨率问题直接不显示，这是很多新手踩的坑！

3. 确认图层正确添加到渲染树 #

如果你是把CATextLayer作为SCNBox的材质，要确保把图层正确赋值给材质的diffuse内容：

let material = SCNMaterial()
material.diffuse.contents = textLayer // 这里要把文本层传给材质
box.materials = [material]

如果只是把文本层加到普通UIView的图层上，别忘了调用view.layer.addSublayer(textLayer)。

4. 排查字符串本身的问题 #

虽然print能输出，但可以试试清理字符串里的不可见字符：

let cleanText = message.text.trimmingCharacters(in: .whitespacesAndNewlines)
textLayer.string = cleanText

给你一个完整的示例参考（Message类的实现）：

class Message {
    let content: String
    
    init(content: String) {
        self.content = content
    }
    
    func createTextLayer(for box: SCNBox) -> CATextLayer {
        let textLayer = CATextLayer()
        
        // 核心配置
        textLayer.string = content
        textLayer.font = UIFont.systemFont(ofSize: 14)
        textLayer.foregroundColor = UIColor.white.cgColor
        textLayer.alignmentMode = .center
        
        // 尺寸匹配
        textLayer.frame = CGRect(x: 0, y: 0, width: box.width, height: box.height)
        textLayer.contentsScale = UIScreen.main.scale // 关键！
        
        return textLayer
    }
}

你可以先按这个思路排查，大概率是某一个小细节没配置到位~

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