C++怎么使用SQLite C++接口创建本地数据库-C++-PHP中文网

sqlite官方仅提供c接口（sqlite3.h），所谓c++接口实为第三方封装库如sqlitecpp；原生c api用sqlite3_open创建数据库，sqlitecpp则通过sqlite::database构造函数配合open_create标志实现，二者头文件、链接方式及错误处理机制完全不同。

c++怎么使用sqlite c++接口创建本地数据库

SQLite C++ 接口不是官方提供的

SQLite 官方只提供 C 接口（sqlite3.h），所谓 “SQLite C++ 接口” 通常指第三方封装库，最常用的是 SQLiteCpp。如果你直接搜 sqlite3_open 却写 C++ 类风格代码，大概率会编译失败或链接不到符号——因为没引入 C 封装层或没正确链接 libsqlite3。

所以第一步必须明确：你用的是原生 C API 还是 SQLiteCpp？两者创建数据库的写法、头文件、链接方式完全不同。

用原生 C API 创建数据库（最轻量、无依赖）

这是最直接、零额外依赖的方式，适用于嵌入式或极简项目。核心就是调用 sqlite3_open，它在数据库文件不存在时自动创建：

#include <sqlite3.h>
#include <iostream><p>int main() {
sqlite3* db;
int rc = sqlite3_open("example.db", &db);
if (rc != SQLITE_OK) {
std::cerr </p>
<ul>
<li>
<code>sqlite3_open</code> 第二个参数是输出型指针，成功后 <code>db</code> 指向有效句柄</li>
<li>路径支持相对路径（如 <code>"./data/app.db"</code>）和绝对路径；若目录不存在，<code>sqlite3_open</code> 不会自动创建父目录，会报 <code>SQLITE_CANTOPEN</code>
</li>
<li>必须链接 <code>-lsqlite3</code>（Linux/macOS）或链接 <code>sqlite3.lib</code>（Windows）</li>
<li>不要用 <code>sqlite3_open_v2</code> 除非你明确需要控制 flags（比如只读打开但误设 <code>SQLITE_OPEN_CREATE</code> 可能静默失败）</li>
</ul>
<h3>用 SQLiteCpp 创建数据库（更 C++ 化，但需编译依赖）</h3>
<p>SQLiteCpp 是头文件 + 少量源码的封装，把 C 风格的回调、<code>char*</code> 错误信息转成异常和 RAII。但它不改变底层行为——创建数据库仍是调用 <code>sqlite3_open</code>。</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14"><img
														src="https://img.php.cn/upload/manual/001/431/639/6ac8b33c327c4749.png" alt="C++14" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="overflowclass">C++14</a>
													<p class="overflowclass">C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。</p>
												</div>
												<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>
<p>安装后（推荐 v3.3+），代码更简洁：</p>
<pre class="brush:php;toolbar:false;">#include <sqlitecpp>
#include <iostream><p>int main() {
try {
SQLite::Database db("example.db", SQLite::OPEN_CREATE | SQLite::OPEN_READWRITE);
std::cout </p>
<ul>
<li>
<code>SQLite::OPEN_CREATE</code> 是关键：没有它，数据库文件不存在时会抛 <code>SQLite::Exception</code>
</li>
<li>构造函数内部仍调用 <code>sqlite3_open_v2</code>，所以同样受路径权限、目录存在性限制</li>
<li>需要 CMake 链接 <code>SQLiteCpp</code> 库，并确保 <code>libsqlite3</code> 已安装（SQLiteCpp 不自带 SQLite 引擎）</li>
<li>别漏了 <code>SQLite::OPEN_READWRITE</code> —— 单独 <code>OPEN_CREATE</code> 不隐含可写权限</li>
</ul>
<h3>常见失败原因和绕过方法</h3>
<p>无论用哪种方式，“创建失败” 很少是因为 SQLite 本身有问题，多数卡在环境或路径上：</p>
<ul>
<li>当前进程对目标路径**无写权限**（尤其 Windows 上 C:\ 或 macOS 的 /System 目录）→ 改用用户目录：<code>"$HOME/myapp.db"</code> 或 <code>std::filesystem::temp_directory_path()</code>
</li>
<li>指定路径含**不存在的父目录**（如 <code>"data/db/example.db"</code> 但 <code>data/db/</code> 未创建）→ 提前用 <code>std::filesystem::create_directories</code> 创建</li>
<li>文件被其他进程（如 DB Browser、另一个程序）**独占打开** → 关闭所有可能访问该文件的工具，或加 <code>SQLITE_OPEN_FULLMUTEX</code>（C API）提高并发鲁棒性</li>
<li>交叉编译时链接了错误架构的 <code>libsqlite3</code>（如 x86_64 库链接到 arm64 项目）→ 检查 <code>file $(which sqlite3)</code> 和你的链接库是否匹配</li>
</ul>
<p>真正容易被忽略的是：SQLite 创建数据库文件只是“空壳”，不带任何表或 schema。下一步建表前，别误以为“文件存在=数据库就绪”——得执行 <code>CREATE TABLE</code> 才算真正初始化完成。</p></iostream></sqlitecpp>

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！