macOS SwiftUI添加cornerRadius修饰符后焦点顺序异常原因及解决方法

异常焦点错配的根本原因 #

• SwiftUI默认的焦点遍历逻辑是隐式计算的：系统会沿着视图渲染树的层级顺序，自动识别所有可聚焦控件，按照从上到下、从左到右的视觉顺序分配初始焦点和键盘跳转顺序。
• cornerRadius属于会触发离屏渲染的视图修饰符，执行后会在自定义YellowTextField内部的原生TextField外层插入一层额外的图形渲染容器，直接改变了桥接到底层AppKit/UIKit的视图层级路径。
• 系统在做隐式焦点计算时，对带离屏渲染容器的自定义封装组件存在识别偏差：会把插入了额外容器的YellowTextField的层级排序优先级提到了视觉位置更靠上的Name输入框之前，最终出现启动后YellowTextField直接抢占初始焦点的异常。这种行为属于系统焦点自动计算的已知边界问题，和业务代码逻辑无关。
• 当注释掉cornerRadius修饰符时，YellowTextField内部的TextField没有额外的层级插入，和原生TextField的视图层级完全一致，隐式焦点计算的顺序和视觉顺序匹配，因此运行正常。

规避异常焦点行为的落地方法 #

• 优先使用显式焦点状态管理，完全替代系统隐式焦点逻辑
  不要依赖系统自动分配初始焦点的行为，用@FocusState手动维护所有可聚焦控件的顺序：

  // 定义所有可聚焦控件的枚举
  enum FocusField: Hashable {
      case name
      case yellowField
      case age
  }
  // 声明焦点状态
  @FocusState var currentField: FocusField?
  

  给每个输入框绑定对应的枚举值，在页面完成初始化时手动设置初始焦点为currentField = .name。这种方式下不管组件加了多少渲染修饰符，焦点顺序完全由手动定义的逻辑决定，不会被系统隐式计算打乱。
• 调整修饰符的使用方式，避免触发层级识别bug
  如果不想引入显式焦点管理，可以把cornerRadius修饰符从自定义组件内部挪到组件的外部调用位置，或者改用不会插入额外渲染容器的方式实现圆角效果（比如用.overlay绘制圆角边框），减少对原生TextField视图层级的破坏，避免触发系统焦点计算的偏差。
• 给自定义可聚焦组件添加focusScope修饰符
  在自定义YellowTextField的视图外层添加.focusScope(self)，把组件内部的焦点遍历范围限制在组件自身边界内，避免外层的隐式焦点计算跨层级识别时出现排序错位。

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