UICollectionView焦点无法切换：仅能选中首个Item问题求助

1. 检查CollectionView基础配置 #

• 确认UICollectionView已开启焦点与键盘交互：在viewDidLoad中设置

collectionView.allowsFocus = true
collectionView.keyboardNavigationStyle = .automatic

• 若使用自定义布局，必须正确实现focusItemFrame(at:)方法，系统依赖该方法计算相邻可聚焦Item的位置。

2. 修正Cell的preferredFocusEnvironments实现 #

你之前重写该方法返回collectionView的做法错误，会强制锁定焦点在collectionView本身，而非cell。正确处理方式：

• 若cell内有特定可聚焦子视图（如按钮、文本标签），返回该子视图数组：

override var preferredFocusEnvironments: [UIFocusEnvironment] {
    return [yourFocusableSubview]
}

• 若整个cell作为可聚焦单元，无需重写该方法，保持默认即可。

3. 排查焦点更新拦截逻辑 #

• 检查shouldUpdateFocus(in:)代理方法，禁止无条件返回false，确保合法焦点切换被允许：

func shouldUpdateFocus(in context: UIFocusUpdateContext) -> Bool {
    return context.nextFocusedItem != context.previouslyFocusedItem
}

• 移除多余的自定义UIFocusGuide，错误的焦点引导会打乱默认焦点路径。

4. 验证Item可聚焦状态 #

• 在cellForItemAt:中确认每个cell的isFocusable属性为true（默认值为true，但可能被意外修改）：

cell.isFocusable = true

• 确保只有可见、可用的cell允许被聚焦，避免隐藏或禁用状态的cell干扰焦点切换。

5. 调试焦点环境层级 #

• 使用Xcode的Debug View Hierarchy工具，检查collectionView的父视图是否存在焦点拦截（如clipsToBounds设置、覆盖视图），确保焦点能正常穿透到collectionView的item上。

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