SwiftUI 撸码常见错误 2 例漫谈

概述

在 SwiftUI 日常撸码过程中，头发尚且还算茂盛的小码农们经常会犯这样那样的错误。虽然犯这些错的原因都很简单，但有时想要快速准确的定位它们却并不容易。

况且这些错误还可能在模拟器和 Xcode 预览（Preview）表现的行为不甚一致，这无疑加大了“驯服”它们的难度。

本文出现的问题在 Xcode 16.1 + iOS 18.1 中仍会存在。

相信学完本课后，小伙伴们倘若以后再遇到与此类似的问题，必将胸有成竹、迎刃而解。

那还等什么呢？Let‘s fix it！！！😉

---

本文对应的视频课在此，欢迎小伙伴们恣意观赏：

SwiftUI 撸码常见错误 2 例漫谈

---

1. TabView 每个标签页 tag 类型需要谨慎对待

在下面这个简单的例子中，点击 TabView 内部每个标签页竟然毫无反应！

下面上源代码，你能看出是哪里的问题吗？

enum TabTag: Int {case home = 0, worry, game, user
}@available(iOS 17, *)
@Observable
class Model {var currentSelectingTab = 0
}@available(iOS 17.0, *)
struct Main: View {@State var model = Model()var body: some View {NavigationStack {TabView(selection: $model.currentSelectingTab) {Text("Home").tabItem {Label("Home", systemImage: "house")}.tag(TabTag.home)Text("Worry").tabItem {Label("Worry", systemImage: "figure.fall")}.tag(TabTag.worry)Text("Game").tabItem {Label("游戏", systemImage: "gamecontroller.fill")}.tag(TabTag.game)Text("User").tabItem {Label("用户", systemImage: "person.fill")}.tag(TabTag.user)}.navigationTitle("SwiftUI 初学者常见错误")}        }
}

其实原因很简单：问题就出在 TabView 中每个标签页的 tag 类型上。我们实际使用的是 TabTag 类型，但是向 TabView 构造器 selection 形参绑定的却是整形类型。

所以这个问题解决起来也很容易，只需要将 Model 中对应的属性改为 TabTag 类型即可：

@available(iOS 17, *)
@Observable
class Model {var currentSelectingTab = TabTag.home
}

再次运行代码一切都回归正常了。

但是故事到这里并没有结束。假如我们将代码修改为如下形式，却是能够选择 TabView 中每个标签页的：

struct Main: View {@State var currentSelectingTab = 0var body: some View {NavigationStack {TabView(selection: $currentSelectingTab) {Text("Home").tabItem {Label("Home", systemImage: "house")}.tag(TabTag.home)Text("Worry").tabItem {Label("Worry", systemImage: "figure.fall")}.tag(TabTag.worry)Text("Game").tabItem {Label("游戏", systemImage: "gamecontroller.fill")}.tag(TabTag.game)Text("User").tabItem {Label("用户", systemImage: "person.fill")}.tag(TabTag.user)}}}
}

在上面的代码中，我们仅仅将原来在 Model 中 Int 类型的 currentSelectingTab 直接放到视图 @State 中，并将其与 TabView 的选中操作绑定起来而已。但是这样的话，同样造成了 TabView 标签页 tag 类型的不一致，为何又没有问题呢？

其实，这波“走位”表面看起来貌似可以恣意切换 TabView 各个标签页，但实际却是有问题的。为了拨开迷雾见青天，我们特地为 currentSelectingTab 状态增加了 onChange 监听器：

struct Main: View {@State var currentSelectingTab = 0var body: some View {NavigationStack {TabView(selection: $currentSelectingTab) {//...}}.onChange(of: currentSelectingTab) {_,new in// 永远不会进入此闭包中print("\(new)")}}
}

运行代码可以发现：尽管我们可以切换到不同标签页中，但我们的 currentSelectingTab 状态却从未发生过改变！

所以，最终我们发现了 SwiftUI 中一个“不一致”的场景：在 @Observable 对象中属性类型和 TabView 标签页 tag 不匹配会导致“正确”的交互行为（标签页无法切换），但在 @State 同样的属性却不能。

希望苹果在将来可以将它们一致化。

2. 视图中 @FetchRequest 定义不完整导致的崩溃

另一个隐蔽的问题涉及到 CoreData 为 SwiftUI 视图添加的 @FetchRequest 属性包装器。

@available(iOS 17, *)
struct WorriesView: View {    @FetchRequest(sortDescriptors: [.init(keyPath: \Worry.occurrenceTime, ascending: false)]) var worriesvar body: some View {NavigationStack {List {Section("最近担忧") {}Section("严重担忧") {}Section("其它担忧") {}}.navigationTitle("担忧终结者")}}
}

上面的代码貌似人畜无害，而且在 Xcode 预览中的显示也是无懈可击：

不过，如果我们编译并胆敢在模拟器或真机上运行上述代码，App 就会立即崩溃:

而且从提示来看，很难发现究竟是哪里出了问题。如果不是我们已将问题局限在 @FetchRequest 那行代码上，大家恐怕很难轻易找出罪魁祸首，更何况如果它匿影藏形隐身在海量视图中了。

经常在 SwiftUI 中使用 @FetchRequest 属性修饰器来获取 CoreData 数据的小伙伴们，应该能一眼看出上面代码中的问题，实际上它缺少了 FetchedResults 后半部分的定义，是不完整的：

@FetchRequest(sortDescriptors: 
[.init(keyPath: \V3_Worry.occurrenceTime, ascending: false)]) 
var worries: FetchedResults<V3_Worry>

只要将其补全即可。

该问题的另一个特点是它在 Xcode 预览中讳莫如深、深藏不露，只为在实际运行时给秃头码农们“当头一棒”，实属可恨！

不过，通过上面条分缕析的介绍，现在小伙伴们对它们一定能够火眼金睛、无所畏惧，棒棒哒！💯

---

更多 Xcode 预览调试中的技巧和陷阱，请小伙伴们移步如下链接观赏精彩的内容：

• Xcode编写SwiftUI代码时一个编译通过但导致预览(Preview)崩溃的小陷阱
• Xcode如何在预览(Preview)调试中避免与SwiftUI正常运行时环境不一致导致的崩溃
• Xcode预览(Preview)显示List视图内容的一个Bug及解决
• Xcode 15 预览 SwiftUI 视图中 @FetchRequest 查询结果不能正确刷新的解决

---

总结

在本篇博文中，我们讨论了 Xcode 16.1（iOS 18.1）中仍然存在 SwiftUI 的两个“鸱张鼠伏”、较难发现缘由小问题的“症状”和解决之道，希望可以帮助到大家。

感谢观赏，再会啦！😎