GRDB.swift 入门教程4 步搞定 App 的本地 SQLite 数据库【免费下载链接】GRDB.swiftA toolkit for SQLite databases, with a focus on application development项目地址: https://gitcode.com/GitHub_Trending/gr/GRDB.swift给 iOS App 挑本地存储方案是开发初期绕不开的第一个决定。GRDB.swift 是一款 Swift 的 SQLite 库引擎是 SQLiteAPI 全是 Swift从建表、类型安全查询到数据观察都帮你包办也不用继承任何基类就能改造现有类型。下面先理清选型思路再带你走一遍安装和常用技巧。先用不惯 UserDefaults 的那一刻当你的 App 数据从几个配置项长成几百条记录要筛选、要排序、甚至要离线缓存时键值存储就开始失灵了没法按条件查、没法排序每次读取还得把所有东西整包倒进内存。这时 iOS 数据持久化方案大致四条路线差别很明显方案适合放什么一句话评价UserDefaults开关、偏好等少量键值写得快但不能查询扛不住成批数据Core Data官方全家桶式持久化功能全但偏重学习曲线陡Realm对象式数据库API 直观体积偏大透明度不如关系型裸写 SQLite想完全掌控 SQL性能好但映射和并发都得自己兜底GRDB.swift 的位置落在第四格但把自己兜底的部分接走了引擎还是标准 SQLite上面用 Swift 封装出类型安全查询、并发调度和数据观察。它轻量、SQL 可见现有类型只要遵循对应协议就能接入。GRDB 安装与初始化步骤两条路任选 安装很标准。SPM 路线Xcode 里选 Add Package Dependencies填入项目远程地址把 GRDB 加进 targetCocoaPods 路线Podfile 里写一行pod GRDB.swift就完事。初始化也只有一行拿文件路径创建一个DatabaseQueue数据库就就绪了文件不存在时会自动创建。想快速找感觉可以跑一下仓库里的 GRDBDemo 示例应用是个能直接跑的玩家列表 Demo。3 步写出第一个类型安全查询第 1 步让模型遵循两个协议FetchableRecord 负责从行里取出来MutablePersistableRecord 负责写回数据库。声明表名和字段模型就齐了struct Player: Codable, FetchableRecord, MutablePersistableRecord { static let databaseTableName players var id: Int64? var name: String var score: Int }大白话模型就是个普通 struct不用继承谁列名默认跟字段同名。第 2 步建表在写操作里声明表结构一个自增主键加两列顺手把 notNull 之类的约束也加好。后续要升级表版本时官方有专门的迁移机制实现就放在 Migration 目录里按版本号逐步演化不会一上来就推倒重来。第 3 步把筛选、排序、取数串成链let top try Player.filter(Column(score) 500) .order(Column(score).desc) .fetchAll(db)filter 管谁有资格order 管怎么排队fetchAll 管真的取出来。想偷看生成的 SQL把请求打印出来就能看到。DatabaseQueue 还是 DatabasePool按流量选 这是用 GRDB.swift 时第一个要想清楚的分支点它决定数据库的并发行为。DatabaseQueue读写都走同一条串行队列简单可预期多数 App 用这就够了。DatabasePool读可以并行写保持串行适合信息流、后台处理这类多路并发读的场景。选择逻辑一句话默认上 Queue等真的出现多个模块同时读数据、读成为瓶颈时再换 Pool。让界面跟着数据库走ValueObservation 列表页想随数据变化自动刷新别自己写通知。用ValueObservation.tracking声明一份我关心的数据比如取全部玩家再挂一个回调。之后任何碰到被追踪区域的写入都会自动重跑查询、把新值推给你配合 async/await 或 Combine 就能直接驱动 SwiftUI 和 UIKit。避坑与调优三个低成本动作️ 这三条性价比最高批量操作进事务一次插几百条包在一个事务里统一提交磁盘往返会明显减少。给高频查询列建索引常出现在 WHERE、ORDER BY 里的列建一次索引受益很久。别混用连接Queue 和 Pool 选定一个就坚持下去别自己跨线程传递 Database 对象。选型前自检该用 GRDB.swift 的三种情况以及该放过的两种✅ 对着下面两列打勾结论就出来了适合接入手数据超过几百条且要筛选、排序、聚合想直接写 SQL不被对象模型层绑住读侧有并发希望有可预期的并行读适合放过只有寥寥几个配置项UserDefaults 就够用团队已重度投入 Core Data CloudKit 同步生态换掉的边际收益很小如果接手一列勾中两条以上就可以直接上。仓库 Documentation/ 目录里的主文档和示例是配套的边跑边读最顺。【免费下载链接】GRDB.swiftA toolkit for SQLite databases, with a focus on application development项目地址: https://gitcode.com/GitHub_Trending/gr/GRDB.swift创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考