从 GitHub 拉了一个大约三年前的 SwiftUI 示例，想在新版 Xcode 里跑起来练手。一编译就炸，典型报错包括：
Cannot find type 'BindableObject' in scope
Unknown attribute 'ObjectBinding'第一反应是「是不是没 import SwiftUI」，其实不是——是 API 已经改名/弃用，旧教程里的类型在当前 SDK 里根本不存在了。
原因
SwiftUI 早期（beta / 初版）用过一批命名；正式演进后，数据流相关 API 换成了今天更熟悉的一套。苹果开发者论坛和迁移说明里也提到：旧名字不再提供，需要手动替换。
替换对照（按我当时的处理）
| 旧 API | 新 API |
| --- | --- |
| BindableObject | ObservableObject |
| ObjectBinding | ObservedObject |
| NavigationButton | NavigationLink |
也就是说：协议/类型从 BindableObject 换成 ObservableObject，属性包装器从 @ObjectBinding 换成 @ObservedObject（后续还有 @StateObject、@EnvironmentObject 等，按生命周期选用）。导航按钮控件同理换成 NavigationLink。
建议步骤
- 全局搜索旧名字，按上表替换。
- 确认
import Combine（ObservableObject/@Published常一起用）。 - 再编译；若还有弃用警告，按 Xcode 提示继续改（SwiftUI 这几年改动频繁，三年前的项目几乎总会再踩几处）。
为何记下
一人公司偶尔要复活旧 Demo、接客户半成品。SwiftUI 的坑经常不是逻辑错，而是版本代差。把这组替换记下来，打开古董项目时先「搜旧 API → 批量替换」，比从零对照 WWDC 视频快。遇到 Cannot find type ... in scope，先怀疑弃用，再怀疑拼写。
No comments yet