NSTextField鼠标事件触发内存泄漏问题求助

问题复现场景 #

在macOS平台下，新增的NSTextField出现此前未遇到的内存泄漏问题，已在极简项目中稳定复现：

• 基于Xcode创建标准项目，仅在ViewController的viewDidLoad方法中添加一个基础NSTextField（代码如下）
• 页面首次加载完成后，Xcode内存图谱未检测到泄漏；但每点击一次文本框内容，就会新增一个泄漏对象，点击N次则出现N个独立泄漏
• 在多视图控制器项目中，即使切换视图控制器并释放NSTextField实例，泄漏对象仍持续存在，无法被回收

复现代码 #

import Cocoa

class ViewController: NSViewController {

    override func viewDidLoad() {
        super.viewDidLoad()

        let usernameField = NSTextField(string: "Test")
         
        self.view.addSubview(usernameField)
        usernameField.translatesAutoresizingMaskIntoConstraints = false
        usernameField.centerXAnchor.constraint(equalTo: self.view.centerXAnchor).isActive = true
        usernameField.centerYAnchor.constraint(equalTo: self.view.centerYAnchor).isActive = true
        usernameField.widthAnchor.constraint(equalTo: self.view.widthAnchor, multiplier: 0.8).isActive = true
        usernameField.heightAnchor.constraint(equalToConstant: 36).isActive = true
    }

    override var representedObject: Any? {
        didSet {
        // Update the view, if already loaded.
        }
    }
}

排查与解决方向 #

1. 验证系统与SDK版本兼容性 #

从现象来看，大概率是AppKit版本变更引入的问题：

• 测试不同macOS系统版本（如Ventura 13.x、Sonoma 14.x），确认泄漏是否仅出现在特定版本
• 切换Xcode对应的SDK版本（比如用Xcode 14对应macOS 13 SDK），对比泄漏是否消失

2. 定位泄漏对象的引用链 #

通过Xcode内存图谱工具，查看泄漏对象的具体类型和引用关系：

• 重点关注NSTextField内部的文本编辑组件（如NSTextView、NSLayoutManager、NSTextStorage）是否存在循环引用
• 检查是否有系统内部的代理或闭包持有了NSTextField实例未释放

3. 显式管理文本字段生命周期 #

尝试将NSTextField声明为视图控制器的属性，而非临时变量，并手动管理其生命周期：

class ViewController: NSViewController {
    private var usernameField: NSTextField!

    override func viewDidLoad() {
        super.viewDidLoad()
        usernameField = NSTextField(string: "Test")
        // 约束添加代码保持不变
        self.view.addSubview(usernameField)
        // ... 约束设置
    }

    override func viewWillDisappear() {
        super.viewWillDisappear()
        usernameField.removeFromSuperview()
        usernameField = nil
    }
}

显式持有并手动释放可以排除临时变量的释放时机问题，也能验证系统是否对临时创建的NSTextField存在异常持有逻辑。

4. 禁用文本编辑相关特性 #

部分文本编辑特性可能触发内部泄漏，尝试逐一禁用测试：

• 设置usernameField.allowsEditingTextAttributes = false
• 关闭拼写检查：usernameField.autocorrectionType = .no
• 禁用智能引号/破折号：usernameField.smartQuotesType = .no

5. 提交Apple Bug Report #

如果以上方法均无法解决，且确认是AppKit框架的问题：

• 整理详细的泄漏报告，包括内存图谱截图、系统版本、SDK版本、可复现项目
• 通过Apple开发者中心提交Bug Report，帮助官方定位修复问题

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