如何禁用SwiftUI中searchable搜索栏的自动修正功能

iOS 16及以上版本 #

系统已经原生支持对搜索栏应用输入相关修饰符，直接在使用.searchable的视图层级添加.textInputAutocorrection(.never)即可生效，同时也可以搭配禁用自动大写的修饰符使用：

NavigationStack {
    List(/* 数据源 */) { item in
        // 列表项实现
    }
    .searchable(text: $searchText)
    .textInputAutocorrection(.never) // 禁用自动修正
    .autocapitalization(.none) // 按需添加，禁用首字母自动大写
}

该配置只会作用于当前导航结构下的搜索栏，不会影响页面内其他TextField的输入行为。

iOS 15兼容版本 #

iOS 15的SwiftUI没有为.searchable直接暴露对应的输入配置接口，但可以通过UIKit的公开外观协议UIAppearance实现配置，不需要自定义搜索栏，无需修改原有.searchable的调用逻辑：

全局配置方案 #

在App的初始化方法中设置全局UISearchBar的输入行为：

@main
struct YourApp: App {
    init() {
        // 全局禁用所有搜索栏的自动修正
        UISearchBar.appearance().autocorrectionType = .no
        // 按需添加，全局禁用首字母大写
        UISearchBar.appearance().autocapitalizationType = .none
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

单页面配置方案 #

如果不需要全局修改，只需要修改特定页面的搜索栏行为，可以在对应页面的生命周期方法中切换配置：

struct TargetSearchPage: View {
    @State private var searchText = ""
    
    var body: some View {
        NavigationView {
            List(/* 数据源 */) { item in
                // 列表项实现
            }
            .searchable(text: $searchText)
            .onAppear {
                UISearchBar.appearance().autocorrectionType = .no
            }
            .onDisappear {
                // 页面消失时恢复默认配置，避免影响其他页面
                UISearchBar.appearance().autocorrectionType = .default
            }
        }
    }
}

以上基于UIAppearance的方案使用的是系统公开API，不存在App Store审核风险，无需引入第三方依赖或自定义UIViewRepresentable实现。

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