SwiftUI中ObservableObject变量加/不加@Published的差异及最佳实践

为什么没加@Published视图还能正常更新？ #

你当前场景下视图能更新只是偶然巧合：signIn是异步方法，在Task执行完毕回到主线程后，SwiftUI可能因为Task完成的副作用（比如后续准备执行dismiss）触发了视图body的重新计算，刚好读取到了最新的errorMessage。但这种更新不是响应式的，完全依赖视图被动重绘的时机，并不可靠。

加与不加@Published的核心差异 #

• 加@Published：系统自动为属性绑定发布订阅逻辑，每当属性值改变时，会自动发送objectWillChange通知，SwiftUI收到通知后会立即更新视图。这是SwiftUI响应式架构的标准做法，更新时机明确、稳定。
• 不加@Published：属性变化不会主动通知视图，只有当视图因为其他原因（比如其他@Published属性变化、屏幕旋转、父视图重绘）重新计算body时，才会读取到最新值。这种更新被动且不可预测，一旦场景变化就会失效。

最佳实践与潜在风险 #

最佳实践 #

• 所有需要驱动视图更新的ObservableObject属性，必须显式标记@Published——尤其是像errorMessage这种private(set)的属性，外部无法直接修改，只能通过内部方法更新，必须依赖@Published确保视图感知变化。
• 如果需要自定义更新逻辑（比如更新前做数据校验），可以手动实现属性的willSet方法并调用objectWillChange.send()，效果和@Published一致。
• 保持ViewModel的状态变化和视图更新强绑定，避免依赖偶然的视图重绘，让代码逻辑更清晰可维护。

潜在风险 #

• 若后续修改errorMessage的时机（比如在同步方法中修改，或者在异步任务的中间步骤修改），视图将不会自动更新，导致界面显示的错误信息和ViewModel中的实际状态不一致。
• 依赖偶然重绘会增加调试难度，当出现界面不更新的问题时，很难快速定位到是缺少发布通知还是其他逻辑问题。

修正后的代码示例 #

给errorMessage加上@Published标记，确保响应式更新：

@MainActor
final class AuthService: ObservableObject {
    @Published var email = ""
    @Published var password = ""
    @Published private(set) var errorMessage = "" // 添加@Published

    private func validation() throws {
        if email.isEmpty {
            throw AuthError.emptyEmail
        }
        if password.isEmpty {
            throw AuthError.emptyPassword
        }
    }
    
    func signIn() async -> Bool {
        do {
            try validation()
            let authResult = try await Auth.auth().signIn(withEmail: email, password: password)
            errorMessage = "" // 登录成功时清空错误信息，视图会自动更新
            return true
        } catch {
            errorMessage = error.localizedDescription
            return false
        }
    }
}

如果需要自定义更新逻辑，替代@Published的写法：

@MainActor
final class AuthService: ObservableObject {
    @Published var email = ""
    @Published var password = ""
    private(set) var errorMessage = "" {
        willSet {
            objectWillChange.send() // 手动发送更新通知
        }
    }

    // 其余代码不变...
}

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