Combine的sink接收@Published更新重复问题排查

我正在构建一个搜索字段，期望其值变化时执行对应操作。

视图代码 #

struct SearchView: View {
    @ObservedObject var vm = SearchViewModel()

    var body: some View {
        VStack {
            TextField("Type something", text: $vm.text)
                .font(.title)
                .padding()
                .background(Color.white)
                .cornerRadius(10)
                .shadow(color: .gray, radius: 4, x: 0, y: 2)

            HStack {
                Spacer()

                Button("Paste") {
                    vm.pasteText()
                }
                .buttonStyle(.borderedProminent)

                Button("Clear") {
                    vm.clearText()
                }
                .buttonStyle(.borderless)
            }
            .padding(.top)

            Spacer()
        }
        .padding(.horizontal)
    }
}

视图模型代码 #

class SearchViewModel: ObservableObject {
    @Published var text = ""
    private var subscriptions = Set<AnyCancellable>()

    init() {
        $text
            .sink(receiveValue: { value in
                print("receiveValue: \(value)")
            })
            .store(in: &subscriptions)
    }

    func pasteText() {
        self.text = "Text"
    }

    func clearText() {
        self.text = ""
    }
}

运行现象 #

输入字符（例如字母“A”）时，控制台输出如下：

receiveValue: 
receiveValue: 
receiveValue: 
receiveValue: A
receiveValue: A

具体表现：视图创建时收到第一个空值，聚焦输入框时收到两个空值，输入“A”时收到两次重复输出；点击粘贴/清除按钮时仅触发一次输出。

问题与解答 #

1. 是否可以忽略视图刚加载、未输入任何内容时的首个空值？ #

可以，借助Combine的dropFirst()操作符直接忽略初始值的发送：

init() {
    $text
        .dropFirst() // 跳过视图初始化时的首次空值发送
        .sink(receiveValue: { value in
            print("receiveValue: \(value)")
        })
        .store(in: &subscriptions)
}

如果需要进一步过滤无意义的空值（比如聚焦触发的空值），可以结合filter：

$text
    .dropFirst()
    .filter { !$0.isEmpty } // 仅处理非空值，根据业务需求调整
    .sink(receiveValue: { value in
        print("receiveValue: \(value)")
    })
    .store(in: &subscriptions)
}

2. 为何聚焦输入框时会收到空值？ #

这是SwiftUI的绑定同步机制导致的：当TextField获得焦点时，会主动将当前绑定的text值同步到ViewModel的@Published属性中。由于初始text为空字符串，所以聚焦时会再次发送空值，确保视图状态与ViewModel数据一致。

3. 为何输入内容时会收到重复的值？ #

输入时的重复触发源于两次值更新：

• 第一次：用户输入字符，TextField直接更新绑定的$vm.text，触发@Published属性发送新值；
• 第二次：SwiftUI视图完成刷新后，会再次同步绑定值到ViewModel，导致@Published重复发送相同的内容。

解决方法是用removeDuplicates()过滤连续重复的值，确保相同内容只处理一次：

init() {
    $text
        .dropFirst()
        .removeDuplicates() // 过滤连续重复的相同值
        .sink(receiveValue: { value in
            print("receiveValue: \(value)")
        })
        .store(in: &subscriptions)
}

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