如何在macOS SwiftUI中检测TextEditor用户停止输入的时机

你遇到的实时输入频繁触发保存的问题，可以通过防抖逻辑解决：设定一个等待时长（可自行调整，推荐0.5~2秒），用户连续输入期间不会触发保存，只有停止输入达到设定时长后才会执行一次保存操作，该方案完全兼容 macOS Big Sur 系统，不需要依赖额外的系统事件。

实现步骤 #

1. 导入依赖框架 #

在当前 Swift 文件头部导入 Combine 框架：

import Combine

2. 新增状态变量存储待执行任务 #

在你的 View 结构体中新增两个属性：

// 存储防抖订阅任务
@State private var saveCancellable: AnyCancellable?
// 保存等待时长，单位为秒，可根据需求调整
private let saveDelay: TimeInterval = 1

3. 修改 onChange 逻辑 #

将原有的直接调用保存的逻辑替换为防抖逻辑，修改后的完整代码如下：

@EnvironmentObject private var data: DataModel
var note: NoteItem        
@State var text: String
@State private var saveCancellable: AnyCancellable?
private let saveDelay: TimeInterval = 1

var body: some View {
    HStack {
        VStack(alignment: .leading) {
            TextEditor(text: $text)
                .onChange(of: text, perform: { value in
                    guard let index = data.notes.firstIndex(of: note) else { return }
                    // 实时更新本地数据，这部分不需要延迟
                    data.notes[index].text = value
                    data.notes[index].date = Date()
                    data.notes[index].filename = value.components(separatedBy: .newlines).first ?? "未命名笔记"
                    
                    // 防抖核心逻辑：取消之前未执行的保存任务
                    saveCancellable?.cancel()
                    // 新建延迟保存任务
                    saveCancellable = Just(value)
                        .delay(for: .seconds(saveDelay), scheduler: DispatchQueue.main)
                        .sink(receiveValue: { _ in
                            saveFile(filename: data.notes[index].filename, contents: data.notes[index].text)
                        })
                })
                // 可选：页面关闭时主动触发一次保存，避免未保存的内容丢失
                .onDisappear {
                    guard let index = data.notes.firstIndex(of: note) else { return }
                    saveCancellable?.cancel()
                    saveFile(filename: data.notes[index].filename, contents: data.notes[index].text)
                }
        }
    }
}

可选替代方案（不使用Combine） #

如果你不想引入 Combine，也可以用 GCD 的 DispatchWorkItem 实现相同的逻辑：

// 替换之前的saveCancellable属性
@State private var saveTask: DispatchWorkItem?

// onChange里的防抖逻辑替换为：
saveTask?.cancel()
let task = DispatchWorkItem {
    saveFile(filename: data.notes[index].filename, contents: data.notes[index].text)
}
saveTask = task
DispatchQueue.main.asyncAfter(deadline: .now() + saveDelay, execute: task)

优化点（可选） #

如果你的需求是仅首次创建文件时用第一行文本作为文件名，后续修改第一行内容也不更改已创建的文件名，可以给NoteItem新增一个var isFileCreated: Bool = false属性，修改保存逻辑：

.sink(receiveValue: { _ in
    if !data.notes[index].isFileCreated {
        let filename = value.components(separatedBy: .newlines).first ?? "未命名笔记"
        data.notes[index].filename = filename
        data.notes[index].isFileCreated = true
    }
    saveFile(filename: data.notes[index].filename, contents: value)
})

这样就不会因为后续修改第一行内容导致反复创建新文件。

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