C++如何连接和操作SQLite数据库_C++嵌入式数据库编程与SQLite操作-C++-PHP中文网

C++如何连接和操作SQLite数据库_C++嵌入式数据库编程与SQLite操作

冰火之心

发布： 2025-11-16 20:05:02

原创

197人浏览过

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

c++如何连接和操作sqlite数据库_c++嵌入式数据库编程与sqlite操作

在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><p>if (result != SQLITE_OK) {
std::cerr << "SQL执行失败: " << errMsg << std::endl;
sqlite3_free(errMsg);
}

登录后复制

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

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

查看详情

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;"><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;"><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);