自定义UITextView占位符时UILabel子视图不遵守约束问题

嘿，我之前在自定义UITextView占位符的时候也踩过类似的约束坑，咱们来一步步解决这个问题。你遇到的UILabel不遵守约束的情况，大概率是几个常见的Auto Layout细节没处理好，加上初始化逻辑的小问题，下面给你拆解原因和解决方案：

核心问题分析 #

1. Auto Layout基础配置缺失：你创建的placeholderLabel默认translatesAutoresizingMaskIntoConstraints = true，这会让系统自动生成一套约束，和你手动添加的约束冲突，导致Label不遵守你的布局规则。
2. 初始化逻辑覆盖不全：只在awakeFromNib()里初始化Label，如果是通过代码创建这个UITextView子类，Label根本不会被创建，更别说约束了。
3. 约束未适配TextView内边距：UITextView自带textContainerInset，如果你的Label约束直接对齐父视图边缘，会和实际文本的位置错位，看起来像是约束失效。
4. 未处理文本变化的占位符显示逻辑：这部分虽然不直接影响约束，但会让占位符的显示状态不符合预期，容易误以为是约束问题。

完整解决方案代码 #

下面是经过验证的UITextView子类实现，包含所有必要的细节：

import UIKit

class PlaceholderTextView: UITextView {
    // 占位符文本属性，设置后自动更新Label内容
    var placeholder: String? {
        didSet {
            placeholderLabel.text = placeholder
        }
    }
    
    // 占位符颜色属性，默认浅灰色
    var placeholderColor: UIColor = .lightGray {
        didSet {
            placeholderLabel.textColor = placeholderColor
        }
    }
    
    // 提前初始化占位符Label，设置关键属性
    private let placeholderLabel: UILabel = {
        let label = UILabel()
        label.numberOfLines = 0 // 支持多行占位符
        label.textColor = .lightGray
        label.font = UIFont.systemFont(ofSize: 16) // 可以和TextView字体保持一致
        // 关键！禁用系统自动生成的约束，否则会和自定义约束冲突
        label.translatesAutoresizingMaskIntoConstraints = false
        return label
    }()
    
    // 代码初始化入口
    override init(frame: CGRect, textContainer: NSTextContainer?) {
        super.init(frame: frame, textContainer: textContainer)
        setupPlaceholder()
    }
    
    // XIB/Storyboard初始化入口
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        setupPlaceholder()
    }
    
    // 统一的占位符配置方法
    private func setupPlaceholder() {
        // 添加Label到子视图
        addSubview(placeholderLabel)
        
        // 设置约束，适配TextView的内边距
        NSLayoutConstraint.activate([
            placeholderLabel.topAnchor.constraint(equalTo: topAnchor, constant: textContainerInset.top),
            // 额外加4pt偏移，匹配TextView文本容器的默认内边距
            placeholderLabel.leadingAnchor.constraint(equalTo: leadingAnchor, constant: textContainerInset.left + 4),
            placeholderLabel.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -textContainerInset.right),
            placeholderLabel.bottomAnchor.constraint(equalTo: bottomAnchor, constant: -textContainerInset.bottom)
        ])
        
        // 监听文本变化，动态显示/隐藏占位符
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(updatePlaceholderVisibility),
            name: UITextView.textDidChangeNotification,
            object: self
        )
        
        // 初始状态更新占位符可见性
        updatePlaceholderVisibility()
    }
    
    // 更新占位符显示状态
    @objc private func updatePlaceholderVisibility() {
        placeholderLabel.isHidden = !text.isEmpty
    }
    
    // 记得移除通知观察者，避免内存泄漏
    deinit {
        NotificationCenter.default.removeObserver(self)
    }
}

额外排查技巧 #

如果还是遇到约束问题，可以试试这些调试方法：

• 给placeholderLabel设置一个显眼的背景色（比如label.backgroundColor = .red），这样能直观看到Label的实际位置和尺寸，判断是约束没生效还是其他问题。
• 打开Xcode的Debug View Hierarchy（工具栏上的方块带箭头的按钮），查看Label的约束列表，如果有红色的约束条目，说明存在约束冲突，需要调整约束优先级或者删除冲突的约束。
• 检查TextView的isScrollEnabled属性，如果设置为false，确保Label的约束不会因为TextView高度变化而失效。

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