這篇筆記以圖文並茂的方式記錄 SQLite 在 iOS 上的完整使用流程,從觀念建立一路做到畫面呈現,適合當作入門的操作手冊對照閱讀。
動手之前先釐清幾個名詞,後面的程式碼才看得懂在做什麼。
SQLite 是一個嵌入式關聯式資料庫引擎,整個資料庫就是一個檔案,不需要獨立的伺服器程序。iOS 系統本身內建了 SQLite 函式庫(libsqlite3.dylib/libsqlite3.tbd),所以不必額外安裝任何東西,加入專案並引入標頭檔即可使用。
幾個核心概念:
INTEGER PRIMARY KEY AUTOINCREMENT。




iOS 上有兩種常見做法。一是用 sqlite3_open() 直接開啟(或建立)資料庫檔案,再用 sqlite3_exec() 執行 CREATE TABLE。二是先建立 NSFileManager 確認檔案路徑,避免沙盒目錄結構差異造成找不到檔案。
實務上建議把資料庫路徑抽成一個獨立方法集中管理,並在 App 首次啟動時檢查檔案是否存在,不存在才執行建表,這樣邏輯比散落在各處清楚得多。


寫入時務必使用 sqlite3_prepare_v2() 搭配 sqlite3_bind_* 系列函式綁定參數,而不是用 stringWithFormat: 把值拼進 SQL 字串。前者會自動處理跳脫與型別轉換,後者一旦遇到單引號或恶意輸入就會出問題。



查詢的標準流程是 prepare → bind → step → 取值 → finalize。在 while 迴圈中反覆呼叫 sqlite3_step(),回傳 SQLITE_ROW 代表還有一列,回傳 SQLITE_DONE 代表讀完了。取欄位值用 sqlite3_column_* 系列函式,注意欄位索引從 0 開始。


直接在各個 ViewController 裡寫 SQL 是很糟糕的做法。合理的分層是:把資料庫連線、開關與所有 CRUD 操作收進一個單例類別(例如 DBManager),對外只暴露 -insertRecord:、-fetchAllRecords 這類以模型物件為參數的方法。這樣一來,資料庫換成 Core Data 或其他方案時,只需要改動這一層。

把每一列資料對應為一個 Objective-C 物件,好處是型別明確、程式碼可讀性高,也不必在 controller 裡到處做 dictionary 取值。實作上通常再寫一個 model 與 dictionary 互轉的方法,方便與 JSON 序列化搭配。



把查詢結果塞進 UITableView 的資料源,是最典型的呈現方式。記得在 numberOfRowsInSection 回傳筆數,並在 cellForRowAtIndexPath 中取出對應的 model 設定 cell。




最後一步是確認資料真的存進去了。SQLite 的資料庫檔案位於 App 沙盒中,重新啟動 App 後資料仍在,代表持久化成功。

一定要 finalize。 每個 prepare 出來的 statement 用完都要 sqlite3_finalize(),忘記會造成資源洩漏;同理,sqlite3_open() 之後要有對應的 sqlite3_close()。
把交易包起來。 批次插入時用 BEGIN TRANSACTION 與 COMMIT 包住,效能差距可能是數量級的,因為每條 SQL 單獨提交都要觸發一次磁碟同步。
線程問題。 SQLite 連線不支援跨執行緒共用。若讀寫在背景執行緒進行,請改用 GCD 的序列佇列把所有資料庫操作串起來,避免同時存取。
版本升級。 App 更新後資料表結構可能改變,需要實作 migration 邏輯:比對舊版與新版號碼,依序執行對應的 ALTER TABLE,並把新版本號寫回 PRAGMA user_version。