C++中使用SQLite需先集成库文件，通过sqlite3_open打开数据库，用sqlite3_exec执行SQL语句，查询可用回调函数处理结果，推荐使用sqlite3_prepare_v2预编译语句绑定参数以提高安全性和效率，并始终检查返回值、合理释放资源，确保线程安全，从而实现轻量高效的本地数据存储。

在C++项目中使用SQLite数据库是一种轻量级、高效且无需独立服务器进程的解决方案，特别适合桌面应用、移动应用和嵌入式系统。SQLite将整个数据库存储在一个文件中，支持标准SQL语法，并提供简洁的C API，便于C++调用。下面介绍如何在C++中连接和操作SQLite数据库。

1. 环境准备与SQLite库集成

SQLite是用C语言编写的，其核心库以C接口提供，可以直接被C++程序调用。使用前需获取SQLite开发库：

• 下载SQLite源码：从官网（https://www.sqlite.org）下载 amalgamation 版本（sqlite3.c 和 sqlite7.h），这是最简单的方式。
• 编译集成：将 sqlite3.c 和 sqlite3.h 添加到你的C++项目中，直接编译即可。
• 使用包管理器：Linux下可用 apt 安装：sudo apt install libsqlite3-dev；Windows可通过 vcpkg 或手动链接预编译库。

在代码中包含头文件：

#include 
#include 

2. 打开和关闭数据库连接

使用 sqlite3_open 函数打开一个数据库文件，如果文件不存在则自动创建。

sqlite3* db;
int result = sqlite3_open("example.db", &db);
if (result != SQLITE_OK) {
std::cerr << "无法打开数据库: " << sqlite3_errmsg(db) << std::endl;
return -1;
}
// 使用完成后关闭
sqlite3_close(db);

注意：即使打开失败，db 指针也可能非空，应使用 sqlite3_errmsg() 获取错误信息。

3. 执行SQL语句

使用 sqlite3_exec 可以执行建表、插入、更新等不需要返回数据的操作。

char* errMsg = nullptr;
const char* sql = "CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY, name TEXT, age INTEGER);";
result = sqlite3_exec(db, sql, nullptr, nullptr, &errMsg);
if (result != SQLITE_OK) {
std::cerr << "SQL执行失败: " << errMsg << std::endl;
sqlite3_free(errMsg);
}

第3个参数是回调函数，用于处理查询结果；若不关心结果可设为 nullptr。

4. 查询数据与结果处理

对于 SELECT 查询，可以使用回调方式处理每一条记录：

static int callback(void* data, int argc, char** argv, char** colNames) {
    for (int i = 0; i < argc; ++i) {
        std::cout << colNames[i] << ": " << (argv[i] ? argv[i] : "NULL") << std::endl;
    }
    std::cout << "-----\n";
    return 0;
}
// 调用查询
result = sqlite3_exec(db, "SELECT * FROM users;", callback, nullptr, &errMsg);

该方法适用于简单查询，但对复杂逻辑控制不够灵活。

5. 使用预编译语句（推荐方式）

对于频繁执行或带参数的操作，建议使用预编译语句（prepared statements），它更安全、高效，并防止SQL注入。

sqlite3_stmt* stmt;
const char* insertSql = "INSERT INTO users (name, age) VALUES (?, ?);";
// 预编译
result = sqlite3_prepare_v2(db, insertSql, -1, &stmt, nullptr);
if (result == SQLITE_OK) {
// 绑定参数
sqlite3_bind_text(stmt, 1, "Alice", -1, SQLITE_STATIC);
sqlite3_bind_int(stmt, 2, 25);
// 执行
if (sqlite3_step(stmt) != SQLITE_DONE) {
    std::cerr << "插入失败\n";
}

// 重置语句以便再次使用
sqlite3_reset(stmt);
}
sqlite3_finalize(stmt); // 释放语句资源

预编译语句也适用于查询：
const char* selectSql = "SELECT id, name, age FROM users WHERE age > ?;";
result = sqlite3_prepare_v2(db, selectSql, -1, &stmt, nullptr);
if (result == SQLITE_OK) {
sqlite3_bind_int(stmt, 1, 18);
while (sqlite3_step(stmt) == SQLITE_ROW) {
    int id = sqlite3_column_int(stmt, 0);
    const unsigned char* name = sqlite3_column_text(stmt, 1);
    int age = sqlite3_column_int(stmt, 2);
    std::cout << "ID: " << id << ", 名称: " << name << ", 年龄: " << age << std::endl;
}
}
sqlite3_finalize(stmt);

6. 错误处理与最佳实践

始终检查每个SQLite函数的返回值是否为 SQLITE_OK。
使用 sqlite3_errmsg(db) 获取详细的错误描述。
所有通过 sqlite3_prepare 创建的语句必须用 sqlite3_finalize 释放。
避免拼接SQL字符串传参，优先使用 ? 占位符绑定参数。
在多线程环境中，确保数据库连接访问是线程安全的（SQLite默认支持多线程模式）。

基本上就这些。C++连接SQLite并不复杂，关键是理解其C风格API的使用方式。只要掌握打开、执行、预编译和结果处理这几个核心环节，就能在项目中高效地集成SQLite作为本地数据存储方案。