随着SwiftUI成为iOS开发的主流框架，许多开发者发现，在复杂的界面需求面前，UIKit依然有不可替代的优势。尤其是在处理文本编辑时，SwiftUI原生的TextEditor和TextField功能相对有限，而UIKit的UITextView则提供了更丰富的定制能力。但一个经典难题随之而来：如何在SwiftUI的List中嵌入一个UITextView，同时避免两个滚动视图的冲突？

问题：双滚动冲突

UITextView默认拥有自己的滚动功能，而SwiftUI的List同样是一个滚动容器。当把UITextView直接放入List的单元格时，用户操作文本区域时往往会导致滚动冲突：轻滑文本内容会触发List的滚动，而试图在文本内滚动则可能被List拦截——最终体验极差，甚至导致文本无法正常编辑。

更糟糕的是，如果UITextView高度随着输入动态增长，List需要重新计算单元格高度，这会进一步加剧性能问题。因此，核心需求是：让UITextView在List中完全成为“不滚动”的静态文本区域，所有滚动行为交给List统一管理。

解决方案：UIViewRepresentable + 禁用滚动

苹果提供了UIViewRepresentable协议，允许将任何UIKit视图嵌入SwiftUI层级中。实现一个不滚动的UITextView，只需要在自定义的Representable中设置isScrollEnabled = false，并正确约束其尺寸。

实现步骤

  1. 创建UITextViewRepresentable
    定义一个结构体，遵循UIViewRepresentable协议。在makeUIView方法中创建UITextView实例，并立即禁用滚动： swift func makeUIView(context: Context) -> UITextView { let textView = UITextView() textView.isScrollEnabled = false textView.isEditable = true textView.font = UIFont.preferredFont(forTextStyle: .body) // 其他样式配置 return textView }

  2. 处理动态高度
    默认情况下，UITextView固定帧大小，即便内容超长也不会自动扩展。为了支持动态行高，必须在updateUIView中强制重新设置intrinsicContentSize，或者利用UITextView的sizeThatFits方法。一个常见技巧是： swift func updateUIView(_ uiView: UITextView, context: Context) { // 更新文本内容后，立即重新布局 uiView.text = text uiView.invalidateIntrinsicContentSize() DispatchQueue.main.async { uiView.isScrollEnabled = false // 确保滚动始终关闭 } }

  3. 在List中使用
    在SwiftUI的List中，将自定义的UITextView包装放入ForEach或直接作为List的视图： swift List(items.indices, id: \.self) { index in UITextViewRepresentable(text: $items[index].content) .frame(minHeight: 44) // 保证基础高度 }

关键细节与陷阱

  • 布局优先级：由于UITextView禁用了滚动，其intrinsicContentSize会根据内容自动拉伸。但SwiftUI的List默认使用UITableView的自动高度机制，需要确保UITextView的setContentCompressionResistancePriority和setContentHuggingPriority正确，避免被压缩。
  • 内存与性能：每个单元格中的UITextView都会占用资源。如果列表极长，应考虑使用LazyVStack或仅显示有限数量的编辑项。另外，频繁更新文本时，invalidateIntrinsicContentSize会触发布局计算，需注意避免主线程卡顿。
  • 键盘适配：当用户点击UITextView时，键盘弹出可能遮挡其他单元格。需配合@FocusState或键盘通知调整List的offset，或者使用ScrollViewReader自动滚动到当前编辑位置。

现实应用价值

这一技巧在需要富文本编辑、自定义属性（如链接检测、表情符号渲染）或与UIKit旧有代码库兼容的场景中极为常用。例如，在笔记类App中，用户可能需要在列表式的待办事项中嵌入可编辑的多行文本，而每个项目又是独立单元格。通过禁用滚动，确保整个体验统一由List管理，避免了用户困惑。

展望

SwiftUI不断演进，但UIKit的深度定制能力短期内仍难以完全替代。掌握UIViewRepresentable，等于拥有了一座连接两个世界的桥梁。未来，随着SwiftUI对文本编辑的支持增强（如原生支持isScrollEnabled属性），这种手动包装的工作可能会减少，但理解其原理仍是每位iOS开发者的必修课。

在混合开发中，取舍比纯粹的技术实现更重要。 让UITextView不滚动，看似一个小改动，背后却是对用户体验的深刻洞察——滚动逻辑必须统一，才能真正流畅。