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 <sqlite3.h> #include <iostream>
2. 打开和关闭数据库连接
使用 sqlite3_open 函数打开一个数据库文件，如果文件不存在则自动创建。
立即学习“C++免费学习笔记（深入）”；
sqlite3* db;
int result = sqlite3_open("example.db", &db);
<p>if (result != SQLITE_OK) {
std::cerr << "无法打开数据库: " << sqlite3_errmsg(db) << std::endl;
return -1;
}</p><p>// 使用完成后关闭
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);";
<p>result = sqlite3_exec(db, sql, nullptr, nullptr, &errMsg);</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill11628" title="Windows 图片打印"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d3191a227.jpg" alt="Windows 图片打印" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill11628" title="Windows 图片打印">Windows 图片打印</a>
<p>通过 Python 使用 mspaint /pt 在 Windows 上打印图像——绕过 bash 中文路径编码问题。</p>
</div>
<a href="/xiazai/skill11628" title="Windows 图片打印" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>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;
}
<p>// 调用查询
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 (?, ?);";
<p>// 预编译
result = sqlite3_prepare_v2(db, insertSql, -1, &stmt, nullptr);</p><p>if (result == SQLITE_OK) {
// 绑定参数
sqlite3_bind_text(stmt, 1, "Alice", -1, SQLITE_STATIC);
sqlite3_bind_int(stmt, 2, 25);</p><pre class="brush:php;toolbar:false;">// 执行
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);
<p>if (result == SQLITE_OK) {
sqlite3_bind_int(stmt, 1, 18);</p><pre class="brush:php;toolbar:false;">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作为本地数据存储方案。
