如何实现类似Mail.app的分栏控制器，允许用户调整NSTableView宽度？

嘿，要实现Mail.app那种可以拖动调整主列表宽度的效果其实很省心，核心是利用NSSplitViewController的原生能力——毕竟Mail.app本身就是基于Split View架构的。我给你一步步拆解实现步骤：

1. 确保你的Master-Detail基于NSSplitViewController搭建 #

如果你的项目是用Xcode自带的Master-Detail模板创建的，大概率已经是Split View结构了；如果是手动拼接的视图，建议迁移到NSSplitViewController，它已经封装好了分割线拖动、视图自适应等逻辑，省得自己写复杂的手势和布局代码。

2. 配置Split View的核心属性 #

在你的NSSplitViewController子类里（或者直接在Storyboard中配置），做以下设置：

• 设定分割方向为垂直（左右布局）：splitViewController.isVertical = true
• 将分割线样式改成可拖动的面板样式：splitViewController.splitView.dividerStyle = .paneSplitter（这个样式会显示明显的拖动区域，和Mail.app的交互一致）
• 给Master视图（包含NSTableView的那个VC）设置宽高限制，避免用户把列表拖得太宽或太窄：

  // 在MasterViewController的viewDidLoad方法中添加
  preferredMinimumWidth = 250  // 最小宽度，参考Mail的列表限制
  preferredMaximumWidth = 550  // 最大宽度，可根据需求调整
  

3. 让NSTableView自适应宽度变化 #

确保你的TableView能跟着Master视图的宽度一起伸缩，这里有两种常用方式：

方式一：使用Autoresizing Mask #

在MasterViewController的viewDidLoad里设置：

tableView.autoresizingMask = [.width, .height]

这样当Master视图宽度变化时，TableView会自动填满整个视图区域。

方式二：使用Auto Layout（更推荐） #

如果你的项目用Auto Layout管理布局，给TableView添加全屏约束：

override func viewDidLoad() {
    super.viewDidLoad()
    tableView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
        tableView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
        tableView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
        tableView.topAnchor.constraint(equalTo: view.topAnchor),
        tableView.bottomAnchor.constraint(equalTo: view.bottomAnchor)
    ])
}

4. 可选：保存用户调整的宽度偏好（像Mail那样记住位置） #

如果想让App记住用户上次调整的列表宽度，就监听Split View的resize事件，把宽度存到UserDefaults里：

class MySplitViewController: NSSplitViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        delegate = self
        // 启动时读取之前保存的宽度
        if let savedWidth = UserDefaults.standard.object(forKey: "MasterPaneWidth") as? CGFloat {
            splitView.setPosition(savedWidth, ofDividerAt: 0)
        }
    }
}

extension MySplitViewController: NSSplitViewDelegate {
    func splitViewDidResizeSubviews(_ notification: Notification) {
        // 分割线拖动结束后，保存当前Master视图的宽度
        let masterPaneWidth = splitView.subviews[0].frame.width
        UserDefaults.standard.set(masterPaneWidth, forKey: "MasterPaneWidth")
    }
}

一些注意事项 #

• 不要手动给Split View的子视图设置固定宽度，否则会覆盖Split View的自动布局逻辑
• 如果分割线拖动不灵敏，检查dividerStyle是否设为.paneSplitter（.thin样式的拖动区域很窄，用户很难触发）
• 确保Master视图里的NSScrollView（包裹TableView的那个）也是全屏布局的，否则TableView无法跟着伸缩

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