企业官网建设流程全解析

一劳永逸解决 iOS 键盘遮挡输入框：IQKeyboardManager 完整上手指南

【免费下载链接】IQKeyboardManagerCodeless drop-in universal library allows to prevent issues of keyboard sliding up and cover UITextField/UITextView. Neither need to write any code nor any setup required and much more.项目地址: https://gitcode.com/gh_mirrors/iq/IQKeyboardManager

从"用户看不到自己打的字"说起

做过 iOS 的人都遇到过这种场景：屏幕底部一个输入框，用户一点聚焦，键盘"唰"地弹起来，刚好把输入框顶到键盘后面。用户只能一边打字一边盲猜键盘有没有收住，体验非常糟糕。

传统做法是每个控制器都去监听keyboardWillShow通知，手动算高度、手动setContentOffset。输入框一多，这套样板代码就散落在项目各个角落，改一处漏一处。

IQKeyboardManager就是为了解决这个 iOS 键盘遮挡问题而生的开源库：全局接管键盘弹出与收起，自动把被挡住的UITextField/UITextView顶到键盘上方，全程不需要你写一行监听代码。

它都能帮你做什么

可以把它理解成给键盘装了个"自动挡"——挂挡之后，换挡、避让、回位都由它自己处理：

• 自动避让：键盘弹出时自动滚动/偏移，保证聚焦的输入框始终可见，横竖屏旋转也都适配
• 工具栏与导航：自动给输入框附上 Previous / Next / Done 工具栏，还能带输入提示音
• 点击空白收起键盘：一行开关，点屏幕空白处即可收键盘
• 模块化拆分：新版按 Core、Toolbar、Resign 等 subspec 划分，只用核心功能时可以只引入 Core，减小包体

下面这张依赖图展示了各模块之间的依赖关系，能看出"只装 Core"是成立的：

两行代码启用 IQKeyboardManager

安装走 Swift Package Manager，在 Xcode 里三步完成：

1. 菜单栏File→Swift Packages→Add Package Dependency
2. 填入仓库地址（IQKeyboardManager 仓库）
3. 选定版本后点Next确认

然后在AppDelegate里打开总开关，这是全文唯一必须的配置：

import IQKeyboardManagerSwift func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { // 总开关：之后所有输入框的键盘避让全部自动生效 IQKeyboardManager.shared.isEnabled = true return true }

为什么写在这里？AppDelegate是全局只有一份的入口，在这里启用一次，App 内所有页面自动生效，不用每个控制器重复设置。

键盘和输入框之间留多少空隙

默认情况下，输入框与键盘顶部之间只有 10pt 的间距，视觉上可能略挤。常用调整就这一条属性：

// 键盘与输入框之间的间距，单位 pt IQKeyboardManager.shared.keyboardDistance = 20.0

调大它，输入框会被顶得离键盘更远，适合底部还有安全区遮挡的场景。其余大多数属性都有合理的默认值，按需查 官方文档 即可，不必一开始就背。

进阶实战：聊天界面与特殊布局

拿聊天页这类典型场景说。列表里每一行都有输入框，此时建议：

• 打开工具栏：IQKeyboardManager.shared.enableAutoToolbar = true，每行输入框自动带"上一个/下一个/完成"按钮，用户可以在多行输入框间快速跳转，不用反复收起再点
• 打开点击空白收起：IQKeyboardManager.shared.resignOnTouchOutside = true，聊天列表里误触后点一下空白就能收键盘，比找 Done 按钮快得多

反过来，也有一种情况需要手动关闭它：比如一个自定义的UIScrollView完全自己管理滚动逻辑，或者某个全屏编辑页要求输入框紧贴键盘。此时可以在该页面viewWillAppear里把isEnabled置为false，离开时恢复为true，让全局自动避让在这一小片区域内"熄火"。官方对这类手动管理的写法有专门说明，参见 已知问题与手动管理文档 所在目录。

和常用库怎么搭配

• RxSwift：它的输入事件可以接到响应式流上，比如editingDidEndOnExit触发收起键盘，与 IQKeyboardManager 的自动避让互不干扰，一个管"事件"，一个管"位置"
• SnapKit：纯代码布局的页面是键盘遮挡的高发区（没有 Auto Layout 场景约束可依赖），IQKeyboardManager 不关心你用什么布局方式，只要输入框是标准 UIKit 组件就能自动顶上去，两者天然互补

常见误区与小结

两个高频坑：

• 把它打进 SDK 里随库发布。官方明确不建议：它设计给 App 项目自身使用，塞进第三方库会和宿主 App 的自定义方案打架
• 和其他会弹输入框的三方库混用时不管。弹出/收起这类第三方 UI 时，记得手动关掉再打开isEnabled，责任在开发者这一侧

总结一句：IQKeyboardManager 用一行isEnabled = true换取全局的键盘避让能力，剩下的间距、工具栏、收起策略都是可选的锦上添花。装上它，键盘遮挡这件事可以从此从你的待办清单里删掉。

【免费下载链接】IQKeyboardManagerCodeless drop-in universal library allows to prevent issues of keyboard sliding up and cover UITextField/UITextView. Neither need to write any code nor any setup required and much more.项目地址: https://gitcode.com/gh_mirrors/iq/IQKeyboardManager