SwiftUI Edit Mode检测及编辑态NavigationLink失效问题

该异常不属于Xcode 13.4.1、iOS 15.5的系统bug，是SwiftUI List组件在系统编辑模式下的预设行为：当List进入editMode状态时，系统会默认拦截行点击触发的NavigationLink跳转事件，交互优先级让位给行删除、重排等内置编辑操作。这也是为什么相同代码放在VStack/Form中预览正常，嵌套进List后编辑态点击无响应——该问题和是否通过@Environment读取编辑状态、使用系统EditButton还是自定义编辑按钮无直接关联。

第一步：手动管理编辑状态，规避系统控件状态同步问题 #

不要依赖系统默认EditButton，直接在列表的父视图持有编辑状态，既可以1:1复刻原生交互，也能避免环境值同步延迟的问题：

// 列表父视图中声明全局编辑状态
@State private var isEditing = false

自定义编辑按钮，完全匹配系统按钮的样式和动效：

.toolbar {
    ToolbarItem(placement: .navigationBarTrailing) {
        Button {
            withAnimation(.default) {
                isEditing.toggle()
            }
        } label: {
            Text(isEditing ? "完成" : "编辑")
                .fontWeight(isEditing ? .bold : .regular)
        }
    }
}

将编辑状态通过环境值绑定给List，可以正常使用系统自带的行删除、移动能力，不会出现状态不同步问题：

List {
    // 行内容
}
.environment(\.editMode, .constant(isEditing ? .active : .inactive))

第二步：改造通用行组件，绕过编辑态跳转拦截 #

不要直接将NavigationLink作为List行的根视图，改用自定义Button+隐藏NavigationLink的触发方案，无论是否处于编辑态都能正常响应点击，同时根据当前编辑状态切换跳转目标：

struct EditableRow<RowContent: View, DetailDestination: View, EditDestination: View>: View {
    // 直接接收父视图传入的编辑状态，无需依赖环境值读取
    let isEditing: Bool
    @ViewBuilder var rowContent: () -> RowContent
    @ViewBuilder var detailDestination: () -> DetailDestination
    @ViewBuilder var editDestination: () -> EditDestination
    
    // 导航触发控制状态
    @State private var triggerNavigation = false
    
    var body: some View {
        ZStack(alignment: .leading) {
            // 隐藏的导航链接，负责实际跳转逻辑
            NavigationLink(isActive: $triggerNavigation) {
                if isEditing {
                    editDestination()
                } else {
                    detailDestination()
                }
            } label: { EmptyView() }
            .opacity(0)
            
            // 自定义按钮响应点击，规避List编辑态的跳转拦截
            Button {
                triggerNavigation = true
            } label: {
                rowContent()
                    .frame(maxWidth: .infinity, alignment: .leading)
                    .contentShape(Rectangle())
            }
            .buttonStyle(.plain)
        }
    }
}

调用示例 #

List {
    EditableRow(
        isEditing: isEditing,
        rowContent: {
            HStack {
                Text("个人分组")
                Spacer()
                Text("12条记录")
                    .foregroundColor(.secondary)
            }
        },
        detailDestination: {
            // 非编辑态跳转的条目详情页
            Text("分组详情页")
        },
        editDestination: {
            // 编辑态跳转的分组编辑页
            Text("分组编辑页")
        }
    )
    // 如需保留行删除、移动能力，正常添加onDelete、onMove修饰符即可
}
.environment(\.editMode, .constant(isEditing ? .active : .inactive))

• 不建议使用AnyView作为行组件的参数类型，上文给出的泛型写法性能损耗更低，也不会出现视图状态丢失的问题
• 行内自定义点击Button必须添加.buttonStyle(.plain)修饰符，否则会触发List默认的整块灰底点击高亮效果，和原生行交互不一致
• 如果项目适配iOS 16+ 采用NavigationStack作为导航容器，只需替换NavigationLink的对应初始化方法，核心跳转逻辑完全通用
• 编辑状态切换的动画已经在自定义按钮的点击逻辑中通过withAnimation包裹，无需额外给List添加动画修饰符，动效表现和系统原生EditButton完全一致

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