C++操作SQLite简明教程：环境配置与核心代码解析

结果或目标

成功在Visual Studio环境中配置SQLite运行库，并能够编译运行通过C++代码对SQLite数据库文件进行创建表、插入数据及查询读取的操作。

准备条件

第1步：了解SQLite的数据类型特性

在进行数据库操作前需明确，SQLite采用“无类型”（Typelessness）设计。虽然建议在表结构中指定列类型（如INTEGER、TEXT、REAL、BLOB、NULL），但SQLite主要根据存储数据的实际类型来决定如何保存。例如，向INTEGER列存入字符串时，若字符串可转换为整数则转换存储，否则保留原样。这种灵活性需注意潜在的类型不一致问题。

第2步：获取并编译SQLite静态库

C++访问SQLite需要引入头文件和链接库文件。由于官方提供的Windows DLL压缩包中通常不包含LIB文件，需自行生成：

1. 下载源文件：从SQLite官网下载 amalgamation 源码包（sqlite-amalgamation-xxx.zip）和DLL包（sqlite-dll-win32-x86-xxx.zip）。
2. 解压准备：将DLL包解压至目录，找到 sqlite3.def 文件。
3. 生成LIB文件：使用Visual Studio自带的工具链。打开命令行，进入解压目录，执行以下命令生成 SQLITE3.LIB：

LIB.EXE /DEF:SQLITE3.DEF /MACHINE:IX86

注意：不同版本的VS可能需要调整参数或路径，确保机器架构（X86/X64）匹配。

第3步：配置Visual Studio项目环境

1. 添加头文件：将 sqlite3.h 添加到项目的包含目录或直接放入工程文件夹，在代码中引用。
2. 链接库文件：将生成的 SQLITE3.LIB 放入项目目录，并在代码顶部使用 pragma 指令自动链接：

#include "sqlite3.h"
#pragma comment(lib, "SQLITE3.LIB")

或者在项目属性中，将 附加依赖项 设置为 SQLITE3.LIB。

真实操作顺序

第4步：初始化数据库连接

使用 sqlite3_open 函数打开或创建数据库文件。该函数返回状态码，需检查是否成功。

sqlite3 * pDB;
char* errMsg;
int res = sqlite3_open("sql.db", &pDB);
if (res != SQLITE_OK) {
    printf("Can't open database: %s\n", sqlite3_errmsg(pDB));
    return -1;
}

第5步：执行非查询语句（建表与插入）

对于不返回结果集的SQL语句（如CREATE、INSERT、DELETE），直接使用 sqlite3_exec。为提高大批量插入性能，建议包裹在事务中。

// 创建表
string strSQL = "create table test (id int, name text);";
res = sqlite3_exec(pDB, strSQL.c_str(), 0, 0, &errMsg);

// 开启事务以加速批量插入
res = sqlite3_exec(pDB, "BEGIN TRANSACTION;", 0, 0, &errMsg);
for (int i = 1; i < 10; ++i) {
    char sql[512];
    sprintf_s(sql, "insert into test values(%d, '%s');", i + 10, "Test Name");
    res = sqlite3_exec(pDB, sql, 0, 0, &errMsg);
}
// 提交事务
res = sqlite3_exec(pDB, "COMMIT TRANSACTION;", 0, 0, &errMsg);

第6步：执行查询语句并处理结果集

查询需要使用回调函数 SelectCallback 来接收每一行的数据。结构体指针用于传递上下文，argc为列数，argv为当前行各列的值，azColName为列名。

// 定义回调函数
static int SelectCallback(void *notUsed, int argc, char **argv, char **azColName) {
    for (int i = 0; i < argc; i++) {
        printf("%s = %s", azColName[i], (argv[i] ? argv[i] : "NULL"));
        if (i != argc - 1) printf(", ");
    }
    printf("\n");
    return 0;
}

// 执行SELECT
strSQL = "select * from test;";
res = sqlite3_exec(pDB, strSQL.c_str(), SelectCallback, 0, &errMsg);
if (res != SQLITE_OK) {
    printf("Select error: %s\n", errMsg);
}

第7步：关闭数据库连接

操作完成后，务必释放资源，关闭数据库句柄。

sqlite3_close(pDB);

完成判断

程序编译无报错，运行后在当前目录下生成 sql.db 文件。控制台正确打印出表中插入的记录数据。即表示C++已成功连接并操作SQLite数据库。

简要总结

SQLite凭借其轻量和高效率成为嵌入式及桌面应用的首选本地数据库。通过手动编译LINK生成静态库，C++开发者可以无需安装额外服务即可实现数据库功能。关键在于理解其灵活的数据类型机制，并正确使用事务提升写入性能。以上就是C++操作SQLite简明教程的详细内容，更多关于C++数据库开发的资料请关注本站其它相关文章！