引言

在 SwiftUI 中，界面并不是通過手動刷新來更新的，而是由狀態驅動的。當狀態發生變化，SwiftUI 會自動識別哪些視圖需要重繪，從而保持 UI 與數據的一致性。這種聲明式的方式大大簡化了界面開發的流程，但也帶來一個問題：狀態到底該怎么管理，才能讓視圖“正確地”更新？

SwiftUI 提供了多種狀態綁定機制，包括?@State、@ObservedObject?和?@EnvironmentObject。它們雖然都是用來驅動視圖更新，但適用的場景、生命周期、綁定方式卻各不相同。一不小心，可能就會遇到“明明數據變了，界面卻不更新”的尷尬場面。

這篇文章將深入講解 SwiftUI 中的三種主要數據綁定方式，結合具體的使用場景和代碼實例，幫助你理清它們的使用邏輯，掌握最佳實踐，避免常見誤區。無論你是剛接觸 SwiftUI 的新手，還是已經在項目中使用它的開發者，這篇文章都能為你在構建可維護、響應式的界面上提供幫助。

實戰場景：用一個用戶頁面串起三種狀態綁定方式

為了更直觀地理解 SwiftUI 中三種核心狀態綁定方式的使用場景和區別，我們來構建一個實際項目中常見的頁面 ——?MineView，即“個人中心”頁面。

這個頁面的功能需求如下：

1. 展示用戶信息：包括昵稱與金幣數量。
2. 金幣顯示開關：點擊“小眼睛”圖標可以切換金幣的隱藏與顯示。
3. 支持頁面跳轉：例如跳轉到設置頁或其他模塊。

針對這些需求，我們分別會用到：

1. @State：用于控制金幣是否顯示，這是一個純粹的視圖內部狀態；
2. @ObservedObject：用于監聽用戶數據模型?PHUserHelper?中的金幣和昵稱變化，這是一個綁定外部可觀察對象的狀態；
3. @EnvironmentObject：用于全局路由控制，通過?RouterHelper?管理跳轉，是一個跨頁面共享的全局狀態。

接下來，我們將按功能拆解的順序，依次介紹這三種狀態綁定方式的使用方法與最佳實踐。

1. 管理局部狀態：@State 控制金幣隱藏/顯示

在 SwiftUI 中，@State?是最輕量也是最常用的狀態綁定方式。它適用于視圖自身內部的小范圍狀態管理，比如按鈕選中、輸入框內容、視圖顯隱等場景。

在我們的?MineView?頁面中，用戶可以點擊一個“眼睛”圖標，切換金幣是否可見。這種行為是一個純粹的 UI 控制，不涉及外部數據源，因此非常適合使用?@State?來管理。

import Foundation
import SwiftUIstruct MineView: View {/// 控制金幣是否顯示@State private var showGold = truevar body: some View {HStack(spacing: 12) {Text("金幣：").font(.headline)// 根據狀態展示金幣數量或密文Text(showGold ? "1280" : "****").bold()// 小眼睛按鈕，用于切換狀態Button(action: {showGold.toggle()}) {Image(systemName: showGold ? "eye" : "eye.slash").foregroundColor(.blue)}}.padding().navigationBarBackButtonHidden().toolbar {ToolbarItem(placement: .navigationBarLeading) {Button(action: {}) {Image(systemName: "chevron.left").foregroundColor(.black)}}ToolbarItem(placement: .principal) {Text(LanguageHelper.localizedString(for: "my_title")).font(.headline).foregroundColor(.primary)}}}
}

• @State?修飾的變量?showGold?是一個?局部狀態，只在當前視圖中使用；
• 當?showGold?的值發生變化時，SwiftUI 會自動刷新依賴它的 UI（即?Text?和?Image）；
• SwiftUI 中的視圖是值類型，@State?讓這些值類型視圖也擁有“持久狀態”的能力。

場景	是否適合用?@State
控制某個按鈕是否選中	? 是
輸入框的實時文本綁定	? 是
控制一個彈窗是否彈出	? 是
管理整個用戶對象或大型數據結構	? 否，考慮?@ObservedObject

2. 監聽數據變化：@ObservedObject?實時更新用戶信息

當視圖需要響應某個外部對象的屬性變化，比如用戶昵稱或金幣數量，就需要使用?@ObservedObject。

在我們的場景中，用戶信息由一個單例類?PHUserHelper?管理，并持有一個?PHUser?模型。我們希望當用戶的金幣數量或昵稱更新時，MineView?頁面能自動刷新顯示的數據。此時就可以用?@ObservedObject?來監聽這些變化。

模型設計

首先，我們定義一個?PHUser?用戶模型，并通過?@Published?修飾其屬性，確保它們發生變化時會通知觀察者（比如視圖）。

class PHUser: ObservableObject {@Published var nickname: String = "未登錄"@Published var gold: Int = 0
}

然后我們創建一個用戶管理類?PHUserHelper，作為單例提供全局訪問。

class PHUserHelper: ObservableObject {static let shared = PHUserHelper()@Published var user = PHUser()
}

視圖中的使用

struct MineView: View {/// 控制金幣是否顯示@State private var showGold = true/// 監聽用戶管理器@ObservedObject var helper = PHUserHelper.sharedvar body: some View {VStack(alignment: .center, spacing: 12) {// 顯示用戶昵稱Text("歡迎你，\(helper.user.nickname)").font(.title2)HStack(spacing: 12) {Text("金幣：").font(.headline)// 根據狀態展示金幣數量或密文Text(showGold ? "\(helper.user.gold)" : "****").bold()// 小眼睛按鈕，用于切換狀態Button(action: {showGold.toggle()}) {Image(systemName: showGold ? "eye" : "eye.slash").foregroundColor(.blue)}}}.padding().navigationBarBackButtonHidden().toolbar {ToolbarItem(placement: .navigationBarLeading) {Button(action: {}) {Image(systemName: "chevron.left").foregroundColor(.black)}}ToolbarItem(placement: .principal) {Text(LanguageHelper.localizedString(for: "my_title")).font(.headline).foregroundColor(.primary)}}}
}

• @ObservedObject?修飾的對象必須是遵循了?ObservableObject?協議的類。
• 被觀察對象的屬性必須使用?@Published?標記，否則屬性改變不會觸發視圖更新。
• 在視圖中使用對象屬性（如?helper.user.gold）時，SwiftUI 會建立“依賴關系”，從而在屬性變動時自動刷新對應 UI。

3. 跨頁面共享狀態：@EnvironmentObject?實現路由跳轉與全局通信

在 SwiftUI 中，@EnvironmentObject?是一種在多個視圖層級間共享數據的方式，適用于跨頁面的全局狀態管理，比如：用戶信息、App 設置、導航跳轉、主題控制等。

在我們的場景中，MineView?可以跳轉到?EditView，用戶在編輯頁中修改昵稱后返回，主頁面應能自動刷新。為了不手動傳遞路由器對象或用戶對象，我們使用?@EnvironmentObject?注入共享實例。

路由管理器：RouterHelper

需要繼承自ObservableObject，代碼如下：

class RouterHelper: ObservableObject {static let shared = RouterHelper()/// 路徑數組，代表導航棧@Published var path: [PDFRoute] = []private init() {}/// 跳轉到某個路由func push(_ route: PDFRoute) {path.append(route)}/// 返回上一級頁面func pop() {if !path.isEmpty {path.removeLast()}}/// 返回到指定頁/// - Parameter index: 要返回到的頁面索引func popTo(index: Int) {guard index >= 0 && index < path.count else { return }path = Array(path.prefix(upTo: index + 1))}/// 返回首頁，清空路徑func popToRoot() {path.removeAll()}}

路由注入及使用

我們通過?.environmentObject()?將路由管理器注入到mine頁及編輯頁。

                    case .mine:MineView().environmentObject(router)

                    case .edit:// 編輯頁面EditView().environmentObject(RouterHelper.shared)

在?MineView?中使用?@EnvironmentObject?接收這個路由對象，并觸發跳轉：

struct MineView: View {@EnvironmentObject var router: RouterHelper@ObservedObject var user: PHUser@State private var showGold = truevar body: some View {VStack(alignment: .leading, spacing: 16) {HStack {Text("歡迎你，\(helper.user.nickname)")Spacer()Button("編輯昵稱") {router.push(.edit)}}// 金幣顯示部分略...}.padding()}
}

編輯頁：修改昵稱并刷新主視圖

編輯頁不需要通過參數傳值，只需在內部使用?@ObservedObject?和?@EnvironmentObject?即可：

import Foundation
import SwiftUIstruct EditView: View {@EnvironmentObject var router: RouterHelper@ObservedObject var user = PHUserHelper.shared.user@State private var input: String = ""var body: some View {VStack(spacing: 20) {TextField("輸入新昵稱", text: $input).textFieldStyle(RoundedBorderTextFieldStyle())Button("保存") {user.nickname = inputrouter.pop() // 返回上一級頁面}}.padding().onAppear {input = user.nickname}}
}

• @EnvironmentObject?適合用于整個 App 中的共享對象，如用戶狀態、導航器、設置等；
• 它無需顯式傳參，SwiftUI 會在視圖樹中查找對應類型的注入對象；
• 一旦數據變化，所有依賴它的視圖都會自動刷新；
• 注意必須在上層注入?.environmentObject(...)，否則會導致運行時崩潰。

場景	是否適合用?@EnvironmentObject
管理全局導航邏輯	? 是
多個頁面需要訪問同一個用戶對象	? 是
只在當前視圖內部使用的數據	? 否，考慮?@State?或?@ObservedObject

結語

SwiftUI 是一個高度響應式的框架，它的核心思想是數據驅動視圖。只要狀態發生變化，視圖就會自動更新。為了支持這種機制，SwiftUI 提供了多種狀態屬性包裝器，而其中最常見的三種就是我們今天講解的：@State、@ObservedObject、@EnvironmentObject。

通過用戶主頁這一現實場景，我們看到了它們各自的使用姿勢與適用范圍。在實際開發中，理解它們的作用范圍、聲明周期管理和視圖響應方式，可以幫助我們更高效地構建清晰、可靠、響應式的用戶界面。

三種狀態綁定方式對比表：

特性	@State	@ObservedObject	@EnvironmentObject
生命周期歸屬	當前視圖	外部傳入的可觀察對象	上層注入的共享對象
適用范圍	小范圍內部狀態（局部 UI 控制）	多視圖間共享狀態	跨層級/全局狀態共享
數據變化后視圖刷新	? 自動	? 自動（只刷新使用該屬性的視圖）	? 自動（所有引用該對象的視圖）
聲明時傳入方式	本地初始化	需要從外部?init()?傳入	必須通過?.environmentObject()注入
示例	控制按鈕開關、輸入框文本等	用戶信息、定時器、下載狀態等	路由器、主題管理器、全局配置等