環境準備
- VS 版本:VS2012+(示例基於 VS2012)
- SQLite 版本:3.8.4.1 (3080401)
- 下載:官網 →
sqlite-dll-win32-x86-.zip、sqlite-amalgamation-.zip(源碼)
32 位程序:預編譯 DLL + 手工生成 .lib
- 解壓 DLL 包得
sqlite3.dll、sqlite3.def。
- 複製
mspdb110.dll(VS 安裝目錄 Common7\IDE\)到 lib.exe 目錄(VC\bin\),否則 lib.exe 報缺失 DLL。
- 管理員命令行生成
.lib:
cd "C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\bin"
lib.exe /MACHINE:IX86 /DEF:C:\sqlite\sqlite3.def /OUT:C:\sqlite\sqlite3.lib
- 刪除剛複製的
mspdb110.dll(避免後續編譯衝突)。
- 項目屬性:
- 包含目錄 +
C:\sqlite
- 庫目錄 +
C:\sqlite
- 附加依賴項 +
sqlite3.lib
- 代碼引用:
#include "sqlite3.h"
#pragma comment(lib, "sqlite3.lib")
- 運行時確保
sqlite3.dll 在 EXE 同目錄或 PATH 中。
64 位程序:源碼直接編譯進項目(無現成 64 位 DLL)
- 下載 Amalgamation 源碼包(
sqlite3.c, sqlite3.h, sqlite3ext.h)。
- 將三文件直接加入項目(Add Existing Item),或放入項目目錄並
#include "sqlite3.c" 在一個 .cpp 中編譯。
- 編譯選項:
/DSQLITE_THREADSAFE=1 /DSQLITE_ENABLE_COLUMN_METADATA 等按需添加。
- 無需額外 .lib/.dll,獨立編譯生成 64 位目標代碼,零部署依賴。
基礎 CRUD 代碼片段
sqlite3 *db;
int rc = sqlite3_open("mydict.db", &db);
if (rc) { fprintf(stderr, "Open failed: %s\n", sqlite3_errmsg(db)); return 1; }
const char *sql = "CREATE TABLE IF NOT EXISTS userpwd(id INTEGER PRIMARY KEY AUTOINCREMENT, pwd VARCHAR(30));";
char *err = 0;
rc = sqlite3_exec(db, sql, 0, 0, &err);
if (rc != SQLITE_OK) { fprintf(stderr, "SQL error: %s\n", err); sqlite3_free(err); }
sqlite3_stmt *stmt;
sqlite3_prepare_v2(db, "INSERT INTO userpwd(pwd) VALUES(?)", -1, &stmt, 0);
sqlite3_bind_text(stmt, 1, "123456", -1, SQLITE_TRANSIENT);
sqlite3_step(stmt);
sqlite3_finalize(stmt);
sqlite3_prepare_v2(db, "SELECT id, pwd FROM userpwd", -1, &stmt, 0);
while (sqlite3_step(stmt) == SQLITE_ROW) {
int id = sqlite3_column_int(stmt, 0);
const char *pwd = (const char*)sqlite3_column_text(stmt, 1);
printf("id=%d, pwd=%s\n", id, pwd);
}
sqlite3_finalize(stmt);
sqlite3_close(db);
常見坑點
- 字符編碼:SQLite 內部 UTF-8,Windows 代碼頁傳入需
sqlite3_bind_text16 或自行轉 UTF-8。
- 線程模式:默認 Serialized(多線程安全),單線程可編譯
SQLITE_THREADSAFE=0 提升性能。
- 事務:批量寫入務必顯式
BEGIN; ... COMMIT;,否則默認每條 INSERT 獨立事務極慢。
sqlite3_prepare_v2 返回 SQLITE_SCHEMA 時需重新準備(Schema 變更)。