Xcode15中SwiftUI Commands的@State变量符号查找失败问题

问题描述 #

使用Xcode 15.0开发SwiftUI应用时，在Commands组件中实现文件导入功能，发现@State变量无法正常读取。调试普通变量显示正常，但@State变量会触发符号查找失败的错误，相关代码及调试结果如下：

示例代码 #

import SwiftUI
import RealmSwift

struct commands: Commands{
    
    @ObservedResults(Book.self) var allBooks
    
    @State private var isShowing = false
    @State private var test = "test"
    private var test2 = "tessssst"
    var fileManager = FileManagerSingelton.shared
    
    var body: some Commands {
        CommandMenu("import"){
            Button("Import File"){
                isShowing.toggle()
            }                       
            .fileImporter(isPresented: $isShowing, allowedContentTypes: [.item]) {result in
                switch result {
                case .success(let url):
                    pass
                case .failure(let error):
                    print(error)
                    return
                    
                }
            }
        }
    }
}

调试结果 #

(lldb) po test
error: Couldn't lookup symbols:
  SpeedReader.commands.test.getter : Swift.String
(lldb) p test
error: Couldn't lookup symbols:
  SpeedReader.commands.test.getter : Swift.String
(lldb) po test2
"tessssst"
(lldb) p test2
(String) "tessssst"

问题原因 #

Xcode 15的SwiftUI框架中，Commands组件的生命周期与普通View存在差异，@State属性包装器是专为View层级设计的状态管理工具，无法在Commands中被正确初始化和管理，导致运行时无法找到对应符号。

解决方案 #

方案1：使用@StateObject管理状态（推荐） #

创建ObservableObject子类统一管理Commands中的状态，替代@State：

import SwiftUI
import RealmSwift

class CommandState: ObservableObject {
    @Published var isShowing = false
    @Published var test = "test"
}

struct CommandsView: Commands {
    
    @ObservedResults(Book.self) var allBooks
    @StateObject private var state = CommandState()
    private var test2 = "tessssst"
    var fileManager = FileManagerSingelton.shared
    
    var body: some Commands {
        CommandMenu("import"){
            Button("Import File"){
                state.isShowing.toggle()
            }                       
            .fileImporter(isPresented: $state.isShowing, allowedContentTypes: [.item]) {result in
                switch result {
                case .success(let url):
                    pass
                case .failure(let error):
                    print(error)
                    return
                    
                }
            }
        }
    }
}

方案2：使用@AppStorage（适合需持久化的状态） #

如果状态需要持久化存储，可使用@AppStorage替代@State：

struct CommandsView: Commands {
    
    @ObservedResults(Book.self) var allBooks
    @AppStorage("isShowingImporter") private var isShowing = false
    private var test2 = "tessssst"
    var fileManager = FileManagerSingelton.shared
    
    var body: some Commands {
        CommandMenu("import"){
            Button("Import File"){
                isShowing.toggle()
            }                       
            .fileImporter(isPresented: $isShowing, allowedContentTypes: [.item]) {result in
                switch result {
                case .success(let url):
                    pass
                case .failure(let error):
                    print(error)
                    return
                    
                }
            }
        }
    }
}

方案3：普通变量+手动触发刷新（临时调试方案） #

仅用于临时调试场景，手动触发状态更新，但不符合SwiftUI状态管理规范，不推荐长期使用：

struct CommandsView: Commands {
    
    @ObservedResults(Book.self) var allBooks
    private var isShowing = false {
        didSet {
            objectWillChange.send()
        }
    }
    private var test2 = "tessssst"
    var fileManager = FileManagerSingelton.shared
    
    var body: some Commands {
        CommandMenu("import"){
            Button("Import File"){
                isShowing.toggle()
            }                       
            .fileImporter(isPresented: Binding(
                get: { isShowing },
                set: { isShowing = $0 }
            ), allowedContentTypes: [.item]) {result in
                switch result {
                case .success(let url):
                    pass
                case .failure(let error):
                    print(error)
                    return
                    
                }
            }
        }
    }
}

说明 #

优先选择方案1，@StateObject是SwiftUI管理非View层级状态的标准方式，能确保状态被正确初始化并实现响应式更新。

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