SQLite 以純 C 實作,天生就是跨平台的:Android 與 iOS 都能使用,甚至能寫出幾乎通用的程式碼,移植成本極低。兩個平台雖然都提供了包裝過的 SQLite,但包裝層一方面妨礙移植,另一方面其效能表現也未必更好,因此直接使用原生 API 反而更可控——何況原生的呼叫方式本身並不難。
Apple 的 SDK 已內建 SQLite,因此只要連結對應的動態連結庫即可。步驟如下:
1. 在專案設定的 Linked Frameworks and Libraries 中點擊「+」。
2. 搜尋 sqlite3,加入 libsqlite3.tbd(舊版 SDK 為 libsqlite3.0.dylib)。
3. 在要使用的檔案中引入標頭:#import <sqlite3.h>。




若要移植到其他平台(Android、嵌入式 Linux 等),則需自行下載原始碼:前往 https://sqlite.org/download.html 取得 sqlite-amalgamation 壓縮檔,裡面包含 sqlite3.c 與 sqlite3.h 兩個檔案,直接拖進專案即可。這種做法的好處是除錯方便,也能自由改造——例如自行加入一層加密、掛上幾個回呼方便與上層互動,或裁掉用不到的功能以精簡程式碼。
後續說明會以純 C 的角度切入。雖然範例在 Xcode 環境下撰寫,但除了連結庫的引用方式不同,其餘邏輯完全一致。
SQLite 的型別系統非常精簡,只有五種儲存類別:
每個類別之下還有依長度細分的子型別,但實務上直接使用上述五種即可。
SQLite 採用動態型別:它不會強制要求你預先宣告欄位型別,實際寫入時會依數值樣貌自動轉換。不過為了查詢效能與資料品質,仍不建議完全依賴這種「無型別」寫法。以下用一個建表語句示範:
CREATE TABLE student (
name TEXT, -- 姓名
no INTEGER, -- 學號
totalScore REAL, -- 總分
photo BLOB -- 照片
);
要操作資料庫,就得先有一個代表它的句柄。這個詞一樣容易讓人卻步,但同樣地,重點不在名稱而在用途。
句柄其實無處不在,最常見的是檔案句柄:要操作檔案,先取得它的句柄。句柄本質上就是一個用來描述目標的結構體,記錄了位置、大小、型別等資訊,程式有了這份描述就能定位並操作該資源。
一句話:句柄是描述物件的結構體。
SQLite 的句柄定義如下(很長,可以直接跳過):
struct sqlite3 {
sqlite3_vfs *pVfs; /* 作業系統介面 */
int nDb; /* 目前使用的後端數量 */
Db *aDb; /* 所有後端 */
int flags; /* 各類旗標 */
int errCode; /* 最近一次錯誤碼 */
u8 autoCommit; /* 自動提交旗標 */
u8 temp_store; /* 1: 檔案 2: 記憶體 0: 預設 */
/* ……其餘欄位從略:快取、鎖與交易狀態、模組表、錯誤訊息、衝突處理函式等 */
};
typedef struct sqlite3 sqlite3;
這個結構體描述的就是磁碟上的資料庫檔案。有了這份描述符,我們便能對資料庫進行各種操作;內部細節暫且不必深究,先把 API 用熟,日後遇到效能或交易議題時再回頭研究即可。
先宣告一個句柄變數,後續所有操作都要靠它:
sqlite3 *pdb;
到這一步就完成了句柄的宣告。接下來要透過 sqlite3_open 讓它與實際的資料庫檔案綁定,再進行新增、刪除、查詢與修改,最後以 sqlite3_close 釋放資源。