使用CATextLayer向UIView绘制文本不显示的问题求助

架构老林

2026-10-6

CATextLayer不显示的原因及修复方案

核心问题原因

未给CATextLayer设置渲染尺寸
你仅配置了position参数指定图层的中心点位置，但没有设置bounds或frame指定图层的宽高，图层默认尺寸为0，无法承载和渲染文本内容。可以直接调用sizeToFit()让图层根据文本内容自动计算适配大小，也可以手动设置固定尺寸。
未赋值文本颜色属性
你的drawText函数虽然传入了fontColor参数，但没有赋值给CATextLayer的foregroundColor属性，文本默认颜色可能和背景重合导致看不到内容。

修复后的实现代码

private func drawText(string: String, at: CGPoint, withFont: CGFont, fontColor: CGColor, fontSize: CGFloat) -> CATextLayer {
    let textLayer = CATextLayer()
    textLayer.string = string
    textLayer.font = withFont
    textLayer.fontSize = fontSize
    textLayer.foregroundColor = fontColor // 补充文本颜色配置
    textLayer.alignmentMode = .center
    textLayer.contentsScale = UIScreen.main.scale
    textLayer.position = at
    textLayer.sizeToFit() // 补充尺寸适配配置
    return textLayer
}