Xcode 14.3.1中TextField等默认背景黑且占位符显示异常求助

问题现象 #

• 使用Xcode 14.3.1开发时，ViewController属性检查器显示默认背景为「system background」，但iOS模拟器中实际显示为黑色，TextField的占位符文本为浅灰色
• 新建空白项目拖拽TextField测试，同样出现黑色背景的问题
• 手动将TextField、tableView及tableViewCell的背景改为白色后，浅灰色占位符因对比度不足无法清晰显示；即使通过代码修改背景为白色，占位符仍处于不可见状态

解决方法 #

1. 修正项目外观模式设置 #

检查项目的Info.plist文件，若存在UIUserInterfaceStyle键且值为Dark，会强制开启深色模式。将该键删除，或把值改为Light，即可恢复默认的浅色背景。

2. 自定义TextField占位符颜色 #

通过代码设置占位符的文本颜色，确保在白色背景下清晰可见：

// 在ViewController的viewDidLoad方法中添加
if let placeholder = textField.placeholder {
    let attrPlaceholder = NSAttributedString(
        string: placeholder,
        attributes: [NSAttributedString.Key.foregroundColor: UIColor.darkGray]
    )
    textField.attributedPlaceholder = attrPlaceholder
}

3. 全局统一配置（可选） #

如果需要对所有TextField和外观模式进行全局设置，可在AppDelegate的application(_:didFinishLaunchingWithOptions:)方法或SceneDelegate的scene(_:willConnectTo:options:)方法中添加以下代码：

// 强制全局使用浅色模式
UIApplication.shared.windows.forEach { $0.overrideUserInterfaceStyle = .light }

// 全局设置TextField占位符颜色
let globalPlaceholderAttr = [NSAttributedString.Key.foregroundColor: UIColor.darkGray]
UITextField.appearance().attributedPlaceholder = NSAttributedString(string: "", attributes: globalPlaceholderAttr)

补充说明 #

若后续出现Xcode自动恢复正常的情况，大概率是Xcode缓存或模拟器状态异常导致。可尝试通过以下操作避免类似问题：

• 清理Xcode缓存：使用快捷键Command+Shift+K
• 重启iOS模拟器
• 重置模拟器内容：点击模拟器菜单栏「Device」→「Erase All Content and Settings」

内容的提问来源于stack exchange，提问作者B.O.M.B