开启usesAutomaticRowHeights后，NSTableView重载单行致子视图布局异常

我有一个NSTableView，每行包含两个标签，一个左对齐、一个右对齐。调用reloadData(forRowIndexes:columnIndexes:)重载单行时，右对齐标签会紧贴左对齐标签。

重载前效果：

重载后效果：

重载整个表格或关闭usesAutomaticRowHeights可解决该问题，能否无需这两种workaround实现单行重载？

class ViewController: NSViewController, NSTableViewDataSource, NSTableViewDelegate {
    
    override func loadView() {
        let tableView = NSTableView()
        tableView.translatesAutoresizingMaskIntoConstraints = false
        tableView.dataSource = self
        tableView.delegate = self
        tableView.usesAutomaticRowHeights = true
        let column = NSTableColumn()
        column.width = 400
        tableView.addTableColumn(column)
        let scrollView = NSScrollView(frame: CGRect(x: 0, y: 0, width: 500, height: 500))
        scrollView.translatesAutoresizingMaskIntoConstraints = false
        scrollView.documentView = tableView
        view = scrollView
        
        Timer.scheduledTimer(withTimeInterval: 2, repeats: false) { _ in
            print("reload")
            tableView.reloadData(forRowIndexes: IndexSet(integer: 2), columnIndexes: IndexSet(integer: 0))
//            tableView.reloadData()
        }
    }
    
    func numberOfRows(in tableView: NSTableView) -> Int {
        return 5
    }
    
    func tableView(_ tableView: NSTableView, viewFor tableColumn: NSTableColumn?, row: Int) -> NSView? {
        let cell = NSTableCellView()
        let textField1 = NSTextField(labelWithString: "hello")
        textField1.translatesAutoresizingMaskIntoConstraints = false
        let textField2 = NSTextField(wrappingLabelWithString: "world")
        textField2.translatesAutoresizingMaskIntoConstraints = false
        textField2.alignment = .right
        let stack = NSStackView(views: [
            textField1,
            textField2
        ])
        stack.translatesAutoresizingMaskIntoConstraints = false
        stack.distribution = .fill
        cell.addSubview(stack)
        NSLayoutConstraint.activate([stack.topAnchor.constraint(equalTo: cell.topAnchor, constant: 0), stack.leadingAnchor.constraint(equalTo: cell.leadingAnchor, constant: 0), stack.bottomAnchor.constraint(equalTo: cell.bottomAnchor, constant: 0), stack.trailingAnchor.constraint(equalTo: cell.trailingAnchor, constant: 0)])
        return cell
    }

}

解决方案 #

问题根源是单行重载时，usesAutomaticRowHeights的布局计算未正确触发NSStackView的完整布局，导致第二个文本字段未获得足够的拉伸空间。以下是两种无需全局重载或关闭自动行高的修复方式：

1. 优化StackView布局约束

给NSStackView添加间距，并确保第二个文本字段能自适应宽度并撑到右侧：

func tableView(_ tableView: NSTableView, viewFor tableColumn: NSTableColumn?, row: Int) -> NSView? {
    let cell = NSTableCellView()
    
    let textField1 = NSTextField(labelWithString: "hello")
    textField1.translatesAutoresizingMaskIntoConstraints = false
    
    let textField2 = NSTextField(wrappingLabelWithString: "world")
    textField2.translatesAutoresizingMaskIntoConstraints = false
    textField2.alignment = .right
    
    let stack = NSStackView(views: [textField1, textField2])
    stack.translatesAutoresizingMaskIntoConstraints = false
    stack.distribution = .fill
    stack.alignment = .centerY
    stack.spacing = 8 // 固定间距，避免标签紧贴
    cell.addSubview(stack)
    
    NSLayoutConstraint.activate([
        stack.topAnchor.constraint(equalTo: cell.topAnchor),
        stack.leadingAnchor.constraint(equalTo: cell.leadingAnchor),
        stack.bottomAnchor.constraint(equalTo: cell.bottomAnchor),
        stack.trailingAnchor.constraint(equalTo: cell.trailingAnchor),
        // 确保右侧标签至少保留自身内容宽度
        textField2.widthAnchor.constraint(greaterThanOrEqualToConstant: textField2.intrinsicContentSize.width)
    ])
    return cell
}

2. 重载后强制触发行布局更新

在调用单行重载后，手动触发目标行的布局刷新，让自动行高重新计算：

Timer.scheduledTimer(withTimeInterval: 2, repeats: false) { _ in
    print("reload")
    let targetRow = 2
    tableView.reloadData(forRowIndexes: IndexSet(integer: targetRow), columnIndexes: IndexSet(integer: 0))
    // 强制更新行布局
    if let cellView = tableView.view(atColumn: 0, row: targetRow, makeIfNecessary: false) {
        cellView.layoutSubtreeIfNeeded()
        tableView.rowHeight = tableView.rowHeight(forRow: targetRow)
    }
}

额外建议：复用TableView Cell

每次创建新的NSTableCellView会增加布局计算开销，建议注册复用标识符优化性能，同时减少布局异常概率：

override func loadView() {
    // ... 原有代码
    tableView.register(NSTableCellView.self, forIdentifier: NSUserInterfaceItemIdentifier("CustomCell"))
    // ...
}

func tableView(_ tableView: NSTableView, viewFor tableColumn: NSTableColumn?, row: Int) -> NSView? {
    let cell = tableView.makeView(withIdentifier: NSUserInterfaceItemIdentifier("CustomCell"), owner: self) as! NSTableCellView
    // 清空旧子视图
    cell.subviews.forEach { $0.removeFromSuperview() }
    
    // 后续添加文本字段和StackView的逻辑同前
    // ...
    return cell
}

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