Liquid Glass：UIKit 适配踩坑实录
内容提要
开发者Megabits总结了iOS 26中UIKit适配的多个坑点：UIBarButtonItem自定义视图出现尺寸和颜色问题，可用SwiftUI解决；角标API内容不更新及按钮顺序异常；NavigationBar背景色导致按钮颜色异常；UITabBarController替换时出现Bug，需等dismiss完成；WKWebView内容延伸至TabBar底部，需加viewport-fit=cover；Stepper位置漂移无解。建议多版本测试，减少非标准设计。
延伸解读
UIKit 自定义视图的兼容性风险
文章指出，在 iOS 26 中，使用 UIKit 的 customView 实现 UIBarButtonItem 时，会出现尺寸和颜色异常。开发者尝试通过添加约束修复尺寸问题，但颜色问题始终无法解决，最终只能改用 SwiftUI 绘制。这提醒我们，在系统更新后，自定义 UIKit 视图可能因内部布局变化而失效，需提前测试并考虑替代方案。
角标 API 的更新陷阱
iOS 26 新增的角标 API 存在内容不更新的问题，开发者通过重新设置 customView 来强制刷新，但这种方法较为 hack。此外，使用 rightBarButtonItems 时可能出现按钮顺序错乱，建议改用新的 trailingItemGroups API。这提示我们，新 API 可能不够稳定，需关注官方推荐用法并做好兼容处理。
NavigationBar 背景色与按钮颜色冲突
在 NavigationBar 上设置背景色已不被推荐，且会导致 UIBarButtonItem 的颜色异常，尤其在深色模式下。开发者通过固定按钮为白色来缓解，但根本问题在于系统对背景色的处理方式变化。这提醒我们，应遵循 HIG 标准，避免使用非标准设计，以减少系统更新带来的适配问题。
系统 Bug 的应对策略
文章列举了多个系统 Bug，如 UITabBarController 替换时出现的问题，需等待 dismiss 完成才能解决；WKWebView 内容延伸至 TabBar 底部，需添加 viewport-fit=cover；Stepper 位置漂移则无解。这些案例表明，系统更新可能引入未知问题，开发者需多版本测试，并尽量减少非标准设计以规避风险。
Q&A
iOS 26 中 UIBarButtonItem 使用 customView 会出现哪些问题？
在 iOS 26 中，如果使用 UIKit 的 customView 来创建 UIBarButtonItem，可能会出现图片尺寸变形（变成非正方形）和颜色丢失的问题。尺寸问题可以通过添加额外的约束（如 widthAnchor、heightAnchor、centerXAnchor、centerYAnchor）来解决，但颜色问题没有直接修复方法，最终建议改用 SwiftUI 的 UIHostingController 来彻底解决。
iOS 26 的角标 API 有哪些坑？如何解决？
iOS 26 的角标 API 存在内容不更新的问题，以及使用 rightBarButtonItems 时按钮顺序可能异常。解决内容不更新的方法是修改角标后强制刷新按钮，例如将 customView 设为 nil 再重新赋值；解决顺序问题可以改用新的 trailingItemGroups 来设置按钮组。
在 iOS 26 中，如果 NavigationBar 设置了背景色，UIBarButtonItem 的颜色会出现什么问题？
如果 NavigationBar 设置了背景色，UIBarButtonItem 的深浅模式会根据底层 ScrollView 的内容变化，但颜色却跟随背景色，导致在深色背景下按钮颜色异常。一个可行的方案是将按钮固定为白色，例如设置 style 为 .prominent 并将 tintColor 设为白色。
在 iOS 26 中替换 UITabBarController 时遇到 Bug 怎么办？
在用户登录后替换 UITabBarController 时，如果立即替换，可能会出现界面显示异常（如按钮错乱）。解决方法是在 dismiss 动画完成后再进行替换。该问题在 iOS 27 中已确认修复。
iOS 26 中 WKWebView 内容延伸到 TabBar 底部怎么办？
在 iOS 26 中，WKWebView 的网页内容会自动延伸到 TabBar 底部，影响 position: fixed 的元素。解决方法是在网页的 META 中加入 viewport-fit=cover，并在 CSS 中使用 env(safe-area-inset-bottom) 和 env(safe-area-inset-top) 来适配安全区域。注意如果有多个 viewport META，每个都需要添加。
iOS 26 中 Stepper 位置漂移的问题有解吗？
Stepper 位置漂移的问题目前无解。当 Stepper 初始位置位于键盘可能遮挡的区域时，即使移动 Stepper 到键盘上方，也可能会发生位置向上漂移。该问题从 iOS 26 第一个版本就存在，直到 iOS 27 仍未修复。
针对 iOS 26 的 UIKit 适配，开发者有什么建议？
开发者建议：1. 尽量使用 SwiftUI 替代 UIKit 的 customView 以避免某些问题；2. 使用新的 API（如 trailingItemGroups）替代旧方法；3. 避免非标准设计，减少与苹果推荐做法不同的地方；4. 在每个 iOS 版本（如 iOS 18、26、27）的设备上进行测试，特别是 Navigation 相关的部分。
