如何为UITextView添加占位文本且跨系统版本精准匹配文本位置

别费劲自己写死边距算位置，所有硬编码偏移量的方案，早晚因为系统版本更新、UITextView属性变动出现错位。

核心原则 #

你要的占位文本位置，本质就是UITextView原生正文内容的起始绘制位置，所有位置参数必须从系统实时排版属性里取，绝对不要写死固定数值。

可落地的对齐方案 #

• 占位控件优先选UILabel，不要用CATextLayer：UILabel和UITextView内部的文本渲染逻辑一致，只要把font、textColor、textAlignment、lineBreakMode属性和UITextView的正文属性完全同步，就不会出现渲染层面的像素级偏移。
• 所有边距实时取系统值，禁止硬编码：
  占位Label的横向偏移 = textView.textContainerInset.left + textView.textContainer.lineFragmentPadding
  占位Label的纵向偏移 = textView.textContainerInset.top
  占位Label的可用宽度 = textView.bounds.width - textView.textContainerInset.left - textView.textContainerInset.right - 2 * textView.textContainer.lineFragmentPadding
• 全节点触发位置更新，不要只监听输入事件：
  • 监听UITextView.textDidChangeNotification，输入内容非空时隐藏占位，内容为空时显示占位
  • KVO监听UITextView的bounds、textContainerInset、font、textContainer.lineFragmentPadding属性，任意属性变动立刻重算占位位置
  • 在UITextView的layoutSubviews方法里调用一次位置更新逻辑，覆盖横竖屏切换、系统隐式布局调整、自适应高度刷新等场景，完全不需要单独适配不同iOS版本的布局差异。

核心位置更新代码参考：

private func refreshPlaceholderLayout() {
    let insertX = textContainerInset.left + textContainer.lineFragmentPadding
    let insertY = textContainerInset.top
    let availableWidth = bounds.width - textContainerInset.left - textContainerInset.right - 2 * textContainer.lineFragmentPadding
    let fitSize = placeholderLabel.sizeThatFits(CGSize(width: availableWidth, height: .greatestFiniteMagnitude))
    placeholderLabel.frame = CGRect(x: insertX, y: insertY, width: availableWidth, height: fitSize.height)
}

零偏差终极方案 #

如果要求像素级完全重合，连渲染偏差都不能有，根本不用加额外的占位视图：直接把占位内容做成带样式的NSAttributedString赋值给UITextView本身。
逻辑非常简单：

1. 非编辑状态下，如果内容为空，直接显示占位的富文本，文字颜色设为占位色
2. 开始编辑的瞬间，如果当前显示的是占位内容，直接清空文本，把文字颜色切回正常输入的颜色
3. 结束编辑的瞬间，如果输入内容为空，重新把占位富文本赋值回去
   这个方案的占位文本是UITextView自己渲染的，和用户输入的内容走完全相同的排版、绘制逻辑，位置不可能出现偏差，唯一需要注意的是提交内容时别把占位文本当成用户输入的真实内容就行。

避坑提醒：别用网上流传的固定边距写法，比如给占位Label加leading=5、top=8的约束——iOS15之前系统默认textContainerInset.top是8pt，iOS17之后部分场景下这个值会调整为10pt，写死8pt必然出现2pt的错位，用户输入和占位内容相同的时候，一眼就能看出位置差。

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