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 或手动链接预编译库。
在代码中包含头文件：
2. 打开和关闭数据库连接
使用
sqlite3_open
函数打开一个数据库文件，如果文件不存在则自动创建。
立即学习
“
C++免费学习笔记（深入）
”；
注意：即使打开失败，
db
指针也可能非空，应使用
sqlite3_errmsg()
获取错误信息。
3. 执行SQL语句
使用
sqlite3_exec
可以执行建表、插入、更新等不需要返回数据的操作。
第3个参数是
回调函数
，用于处理查询结果；若不关心结果可设为 nullptr。
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。
下载
4. 查询数据与结果处理
对于 SELECT 查询，可以使用回调方式处理每一条记录：
该方法适用于简单查询，但对复杂逻辑控制不够灵活。
5. 使用预编译语句（推荐方式）
对于频繁执行或带参数的操作，建议使用预编译语句（prepared statements），它更安全、高效，并防止SQL注入。
}
sqlite3_finalize(stmt); // 释放语句资源
预编译语句也适用于查询：
}
sqlite3_finalize(stmt);
6. 错误处理与最佳实践
始终检查每个SQLite函数的返回值是否为
SQLITE_OK
。
使用
sqlite3_errmsg(db)
获取详细的错误描述。
所有通过
sqlite3_prepare
创建的语句必须用
sqlite3_finalize
释放。
避免拼接SQL字符串传参，优先使用
?
占位符绑定参数。
在多线程环境中，确保数据库连接访问是线程安全的（SQLite默认支持多线程模式）。
基本上就这些。C++连接SQLite并不复杂，关键是理解其C风格API的使用方式。只要掌握打开、执行、预编译和结果处理这几个核心环节，就能在项目中高效地集成SQLite作为本地数据存储方案。
#include
#include
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);
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);
}
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);
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);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;
}