# SwiftUI @Observable vs @State: Wann welches verwenden in 2026 > Beherrsche die Unterschiede zwischen @Observable und @State in SwiftUI, um das richtige Tool für State-Management in iOS-Apps zu wählen. - Published: 2026-02-25 - Updated: 2026-04-29 - Author: SharpSkill - Tags: swiftui, ios, observable, state-management, swift - Reading time: 14 min --- State-Management bildet das Fundament jeder performanten SwiftUI-Anwendung. Seit iOS 17 hat das `@Observable`-Macro die Erstellung reaktiver Modelle revolutioniert, während `@State` weiterhin essenziell für lokalen View-State bleibt. Zu verstehen, wann welches Tool eingesetzt wird, vermeidet unnötige Re-Renders und ermöglicht den Bau flüssiger, reaktionsschneller Apps. > **Was dieser Artikel behandelt** > > Dieser Artikel beleuchtet die internen Mechanismen von `@Observable` und `@State`, ihre grundlegenden Unterschiede und liefert klare Richtlinien zur Wahl des richtigen Tools je nach Kontext. ## Grundlagen von @State `@State` stellt die einfachste Form des State-Managements in SwiftUI dar. Dieser Property Wrapper erzeugt persistenten Speicher für einen Wert, der ausschließlich der View gehört, die ihn deklariert. ```swift // CounterView.swift struct CounterView: View { // @State creates storage managed by SwiftUI @State private var count = 0 var body: some View { VStack(spacing: 20) { // The view updates when count changes Text("Counter: \(count)") .font(.largeTitle) HStack(spacing: 16) { Button("- 1") { count -= 1 } Button("+ 1") { count += 1 } } .buttonStyle(.borderedProminent) } } } ``` Jede Änderung an `count` löst einen Re-Render der View aus. SwiftUI verwaltet den Lebenszyklus dieses Werts automatisch und erhält ihn über Body-Rekonstruktionen hinweg. ### Schlüsseleigenschaften von @State `@State` besitzt mehrere distinktive Eigenschaften, die seinen optimalen Einsatz definieren: ```swift // StateCharacteristics.swift struct FormView: View { // ✅ Simple local state - value types @State private var username = "" @State private var isEnabled = true @State private var selectedIndex = 0 // ✅ Complex value types supported @State private var configuration = FormConfiguration() var body: some View { Form { TextField("Username", text: $username) Toggle("Enabled", isOn: $isEnabled) Picker("Option", selection: $selectedIndex) { Text("Option A").tag(0) Text("Option B").tag(1) Text("Option C").tag(2) } } } } // Structs work perfectly with @State struct FormConfiguration: Equatable { var theme: Theme = .light var fontSize: CGFloat = 16 var showNotifications: Bool = true } enum Theme { case light, dark, system } ``` Der entscheidende Punkt: `@State` arbeitet mit Value-Types (Structs, Enums, primitive Typen). Für Reference-Types (Klassen) sind andere Tools erforderlich. ## Das @Observable-Macro erklärt Mit iOS 17 eingeführt, verwandelt `@Observable` jede Klasse in eine reaktive Datenquelle. Im Gegensatz zum älteren `ObservableObject`-Protokoll bietet dieses Macro feingranulare Beobachtung: Nur Properties, die von einer View tatsächlich gelesen werden, lösen deren Re-Render aus. ```swift // UserModel.swift import Observation // @Observable transforms the class into a reactive source @Observable class UserModel { var name: String = "" var email: String = "" var avatarURL: URL? var preferences = UserPreferences() // Computed properties work too var isValid: Bool { !name.isEmpty && email.contains("@") } } struct UserPreferences { var newsletter: Bool = false var notifications: Bool = true var theme: Theme = .system } ``` Die Magie geschieht zur Compile-Zeit: Das Macro generiert automatisch den notwendigen Tracking-Code für jede Property. ### Granulare Beobachtung in Aktion Der wesentliche Unterschied zum alten `ObservableObject` liegt in der Tracking-Granularität: ```swift // GranularObservation.swift @Observable class ProfileModel { var name: String = "" var bio: String = "" var followerCount: Int = 0 var posts: [Post] = [] } struct ProfileHeaderView: View { let model: ProfileModel var body: some View { VStack { // This view only re-renders if name or bio change Text(model.name) .font(.title) Text(model.bio) .foregroundStyle(.secondary) } } } struct FollowerCountView: View { let model: ProfileModel var body: some View { // This view only re-renders if followerCount changes HStack { Image(systemName: "person.2") Text("\(model.followerCount) followers") } } } struct ProfileScreen: View { @State private var model = ProfileModel() var body: some View { VStack { // Each subview tracks only its dependencies ProfileHeaderView(model: model) FollowerCountView(model: model) Button("Simulate new follower") { // Only re-renders FollowerCountView model.followerCount += 1 } } } } ``` > **Automatisches Tracking** > > SwiftUI analysiert den `body` jeder View, um zu bestimmen, welche Properties gelesen werden. Nur diese Properties lösen bei Änderungen einen Re-Render aus. ## Direkter Vergleich: @Observable vs @State Die Wahl zwischen diesen Tools hängt von mehreren Faktoren ab. Hier ein strukturierter Vergleich: ```swift // ComparisonExample.swift // Scenario 1: Temporary UI state → @State struct ToggleExample: View { @State private var isExpanded = false // ✅ @State appropriate var body: some View { VStack { Button(isExpanded ? "Collapse" : "Expand") { withAnimation { isExpanded.toggle() } } if isExpanded { Text("Detailed content...") } } } } // Scenario 2: Shared business data → @Observable @Observable class CartModel { // ✅ @Observable appropriate var items: [CartItem] = [] var promoCode: String? var total: Decimal { items.reduce(0) { $0 + $1.price * Decimal($1.quantity) } } var itemCount: Int { items.reduce(0) { $0 + $1.quantity } } func addItem(_ item: CartItem) { if let index = items.firstIndex(where: { $0.id == item.id }) { items[index].quantity += 1 } else { items.append(item) } } func removeItem(_ item: CartItem) { items.removeAll { $0.id == item.id } } } struct CartItem: Identifiable, Equatable { let id: UUID let name: String let price: Decimal var quantity: Int } ``` ### Übersicht der Use Cases | Kriterium | @State | @Observable | |-----------|--------|-------------| | Datentyp | Value-Types (struct, enum) | Klassen | | Geltungsbereich | Lokal in einer View | Über Views teilbar | | Komplexität | Einfacher State | Komplexe Business-Logik | | Lebenszyklus | Von SwiftUI verwaltet | Explizit verwaltet | | Re-Render | Gesamte View | Granular pro Property | ## Fortgeschrittene Nutzungsmuster ### @State und @Observable kombinieren In realen Anwendungen koexistieren diese Tools harmonisch. `@State` verwaltet lokalen UI-State, während `@Observable` Geschäftsdaten kapselt. ```swift // CombinedPatterns.swift @Observable class TodoListModel { var todos: [Todo] = [] var filter: TodoFilter = .all var filteredTodos: [Todo] { switch filter { case .all: return todos case .active: return todos.filter { !$0.isCompleted } case .completed: return todos.filter { $0.isCompleted } } } func addTodo(title: String) { let todo = Todo(id: UUID(), title: title, isCompleted: false) todos.append(todo) } func toggleTodo(_ todo: Todo) { guard let index = todos.firstIndex(where: { $0.id == todo.id }) else { return } todos[index].isCompleted.toggle() } } struct Todo: Identifiable, Equatable { let id: UUID var title: String var isCompleted: Bool } enum TodoFilter: CaseIterable { case all, active, completed } struct TodoListView: View { // Business data via @Observable @State private var model = TodoListModel() // Local UI state via @State @State private var newTodoTitle = "" @State private var isAddingTodo = false @State private var selectedTodo: Todo? var body: some View { NavigationStack { VStack { // Filter with Picker Picker("Filter", selection: $model.filter) { ForEach(TodoFilter.allCases, id: \.self) { filter in Text(filter.label).tag(filter) } } .pickerStyle(.segmented) .padding() // Todo list List(model.filteredTodos, selection: $selectedTodo) { todo in TodoRowView(todo: todo) { model.toggleTodo(todo) } } } .navigationTitle("Tasks") .toolbar { Button { isAddingTodo = true } label: { Image(systemName: "plus") } } .sheet(isPresented: $isAddingTodo) { AddTodoSheet(model: model) } } } } struct TodoRowView: View { let todo: Todo let onToggle: () -> Void var body: some View { HStack { Image(systemName: todo.isCompleted ? "checkmark.circle.fill" : "circle") .foregroundStyle(todo.isCompleted ? .green : .secondary) .onTapGesture(perform: onToggle) Text(todo.title) .strikethrough(todo.isCompleted) } } } extension TodoFilter { var label: String { switch self { case .all: return "All" case .active: return "Active" case .completed: return "Completed" } } } ``` ### @Observable mit Dependency Injection Für komplexere Apps ermöglicht die Injektion über das SwiftUI-Environment effektive Entkopplung: ```swift // DependencyInjection.swift @Observable class AuthenticationService { var currentUser: User? var isAuthenticated: Bool { currentUser != nil } func login(email: String, password: String) async throws { // Authentication logic currentUser = User(id: UUID(), email: email, name: "User") } func logout() { currentUser = nil } } struct User: Identifiable, Equatable { let id: UUID let email: String let name: String } // Extension to create an environment key extension EnvironmentValues { @Entry var authService: AuthenticationService = AuthenticationService() } // Configuration in the App @main struct MyApp: App { @State private var authService = AuthenticationService() var body: some Scene { WindowGroup { ContentView() .environment(\.authService, authService) } } } // Usage in views struct ProfileView: View { @Environment(\.authService) private var authService var body: some View { if let user = authService.currentUser { VStack { Text("Hello, \(user.name)") Button("Sign Out") { authService.logout() } } } else { Text("Not signed in") } } } ``` ## Performance und Optimierung ### Unnötige Re-Renders vermeiden Selbst mit der Granularität von `@Observable` können bestimmte Muster die Performance beeinträchtigen: ```swift // PerformanceOptimization.swift // ❌ Bad pattern: reading the entire object struct BadPatternView: View { let model: ProfileModel var body: some View { // Reads model.name AND model.posts even if only name is displayed let _ = model.posts.count // Creates unnecessary dependency Text(model.name) } } // ✅ Good pattern: targeted reading struct GoodPatternView: View { let model: ProfileModel var body: some View { // Tracks only name Text(model.name) } } // ✅ Extract into subviews to isolate dependencies struct OptimizedProfileView: View { let model: ProfileModel var body: some View { VStack { // Each subview has its own dependencies ProfileNameView(model: model) ProfilePostsView(model: model) ProfileStatsView(model: model) } } } struct ProfileNameView: View { let model: ProfileModel var body: some View { Text(model.name) .font(.title) } } struct ProfilePostsView: View { let model: ProfileModel var body: some View { ForEach(model.posts) { post in PostRow(post: post) } } } struct ProfileStatsView: View { let model: ProfileModel var body: some View { HStack { StatBadge(value: model.followerCount, label: "Followers") StatBadge(value: model.posts.count, label: "Posts") } } } ``` > **Teure Computed Properties** > > Computed Properties auf `@Observable` werden bei jedem Zugriff neu berechnet. Bei aufwendigen Berechnungen empfiehlt sich das Caching des Ergebnisses in einer Stored Property. ### Batch-Updates mit withObservationTracking Für fortgeschrittene Szenarien erlaubt `withObservationTracking` das Erkennen von Änderungen ohne Binding: ```swift // ObservationTracking.swift import Observation @Observable class DataSyncModel { var lastSyncDate: Date? var pendingChanges: Int = 0 var isSyncing: Bool = false } class SyncCoordinator { let model: DataSyncModel init(model: DataSyncModel) { self.model = model startObserving() } private func startObserving() { // Observe changes without UI withObservationTracking { // Access that creates dependencies _ = model.pendingChanges _ = model.isSyncing } onChange: { // Called when an observed property changes Task { @MainActor in self.handleModelChange() } } } private func handleModelChange() { if model.pendingChanges > 0 && !model.isSyncing { // Trigger synchronization Task { await syncChanges() } } // Re-establish observation startObserving() } private func syncChanges() async { model.isSyncing = true // Sync logic... model.isSyncing = false model.pendingChanges = 0 model.lastSyncDate = Date() } } ``` ## Migration von ObservableObject Für bestehende Projekte mit `ObservableObject` vereinfacht die Migration zu `@Observable` den Code: ```swift // MigrationExample.swift // ❌ Old pattern with ObservableObject class OldSettingsModel: ObservableObject { @Published var darkMode: Bool = false @Published var fontSize: CGFloat = 16 @Published var notifications: Bool = true } struct OldSettingsView: View { @StateObject private var settings = OldSettingsModel() // or @ObservedObject if injected var body: some View { Form { Toggle("Dark Mode", isOn: $settings.darkMode) Slider(value: $settings.fontSize, in: 12...24) Toggle("Notifications", isOn: $settings.notifications) } } } // ✅ New pattern with @Observable @Observable class NewSettingsModel { var darkMode: Bool = false var fontSize: CGFloat = 16 var notifications: Bool = true } struct NewSettingsView: View { @State private var settings = NewSettingsModel() var body: some View { Form { Toggle("Dark Mode", isOn: $settings.darkMode) Slider(value: $settings.fontSize, in: 12...24) Toggle("Notifications", isOn: $settings.notifications) } } } ``` Vorteile der Migration: - Kein `@Published` mehr auf jeder Property nötig - `@State` ersetzt `@StateObject` für die Erstellung - Automatische granulare Beobachtung - Lesbarerer und wartbarerer Code ## Praktische Entscheidungsregeln Hier ein Entscheidungsleitfaden zur Wahl des richtigen Tools: ```swift // DecisionGuide.swift /* RULE 1: Ephemeral UI state → @State - Animations, transitions - Local form states - Temporary selections - Section expand/collapse */ struct AnimatedCard: View { @State private var isFlipped = false // ✅ Local UI state // ... } /* RULE 2: Shared data across views → @Observable - Business data models - Authentication state - Shopping cart - User preferences */ @Observable class UserSession { // ✅ Shared across app var user: User? var preferences: Preferences // ... } /* RULE 3: Simple struct with binding → @State - Local configuration - Isolated forms */ struct FormData { var name: String = "" var email: String = "" } struct FormView: View { @State private var formData = FormData() // ✅ Struct with @State // ... } /* RULE 4: Complex business logic → @Observable - Validations - Network calls - Data transformations */ @Observable class OrderProcessor { // ✅ Complex logic var items: [OrderItem] = [] var status: OrderStatus = .draft func validate() -> [ValidationError] { /* ... */ } func submit() async throws { /* ... */ } } ``` ## Fazit Die Wahl zwischen `@Observable` und `@State` reduziert sich auf zwei zentrale Fragen: den Datentyp (Wert oder Referenz) und den State-Geltungsbereich (lokal oder geteilt). `@State` glänzt bei einfachem, lokalem UI-State, während `@Observable` bei komplexen Datenmodellen mit granularer Beobachtung überzeugt. ### Entscheidungs-Checkliste - ✅ `@State` für Value-Types und kurzlebigen UI-State verwenden - ✅ `@Observable` für Klassen mit Geschäftsdaten verwenden - ✅ `@Observable` bevorzugen, wenn der State mehrere Views umspannt - ✅ In Subviews extrahieren, um Re-Renders zu optimieren - ✅ Unnötige Property-Lesezugriffe im Body vermeiden - ✅ Schrittweise von `ObservableObject` migrieren - ✅ Environment für Dependency Injection nutzen - ✅ Performance bei komplexen Fällen mit Instruments testen --- Source: SharpSkill (https://sharpskill.dev), tech interview preparation for your real stack. HTML version of this page: https://sharpskill.dev/de/blog/ios/swiftui-observable-vs-state