SwiftUI TextField引发Xcode控制台"FAULT: TUICursorUIViewService"错误

是否需要关注？ #

这个FAULT级别的日志属于系统调试信息，不会导致功能异常、崩溃或用户体验问题，日常开发可以直接忽略，发布版本中这类内部日志也不会被用户看到。

错误成因 #

该错误和macOS平台的文本输入远程视图机制有关：

• SwiftUI的TextField底层依赖Cocoa的NSTextField，而光标UI等组件是通过XPC远程服务（TUICursorUIViewService）提供的NSRemoteView实现的
• 当远程视图所在的窗口未预先配置活力效果（Vibrancy）支持时，系统会输出这条日志，本质是框架内部的配置警告，并非业务代码的错误

解决方法 #

目前没有官方的完美修复方案，但可以通过以下方式处理：

• 直接忽略：这是最省心的方式，因为日志不影响任何功能
• 调整窗口风格：尝试修改App的窗口配置，让系统自动适配活力效果：

  import SwiftUI
  
  @main
  struct YourApp: App {
      var body: some Scene {
          WindowGroup {
              ContentView()
          }
          .windowStyle(HiddenTitleBarWindowStyle())
          .windowToolbarStyle(UnifiedWindowToolbarStyle(showsTitle: false))
      }
  }
  

• 自定义无活力效果的TextField：通过NSViewRepresentable封装NSTextField并手动关闭活力相关配置：

  struct CustomTextField: NSViewRepresentable {
      @Binding var text: String
      let placeholder: String
  
      func makeNSView(context: Context) -> NSTextField {
          let textField = NSTextField()
          textField.placeholderString = placeholder
          textField.isBordered = true
          textField.bezelStyle = .roundedBezel
          textField.delegate = context.coordinator
          // 禁用活力效果相关的自动配置
          textField.wantsLayer = true
          textField.layer?.backgroundColor = NSColor.textBackgroundColor.cgColor
          return textField
      }
  
      func updateNSView(_ nsView: NSTextField, context: Context) {
          nsView.stringValue = text
      }
  
      func makeCoordinator() -> Coordinator {
          Coordinator(self)
      }
  
      class Coordinator: NSObject, NSTextFieldDelegate {
          let parent: CustomTextField
  
          init(_ parent: CustomTextField) {
              self.parent = parent
          }
  
          func controlTextDidChange(_ obj: Notification) {
              guard let textField = obj.object as? NSTextField else { return }
              parent.text = textField.stringValue
          }
      }
  }
  

  使用时替换原TextField即可：

  struct ContentView: View {
      @State private var text: String = ""
  
      var body: some View {
          VStack {
              CustomTextField(text: $text, placeholder: "Enter text...")
                  .padding()
              
              Text("You entered: \(text)")
                  .padding()
          }
      }
  }
  

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