直接用 SQLite C API 的 sqlite3_bind_*() 最可控但需手动处理字段展平、NULL 和参数顺序；ORM 如 SQLiteCpp 能省代码但隐式行为多、调试困难；小项目/性能敏感选原生绑定，中大型项目建议轻量 ORM 配编译期校验；std::string/std::vector 需传 c_str()/data() 及长度，禁用 -1；须显式检查 SQLITE_CONSTRAINT；结构体字段顺序必须与 SQL 占位符严格一致；JSON BLOB 仅适用于嵌套深、动态字段且不按字段查询的场景；浮点比较需用误差范围而非 ==。
SQLite C++ 绑定选 sqlite3_bind_*() 还是 ORM 库？
直接用 SQLite C API 的 sqlite3_bind_text()、sqlite3_bind_int64() 等函数写结构体最可控，但要手动展平字段、处理 NULL、对齐参数顺序；用 ORM（如 SQLiteCpp 或 nanodbc）能省重复代码，但隐式行为多、调试时难定位字段映射失败——比如结构体成员名和表列名大小写不一致，SQLiteCpp::Statement::bind() 不报错却写入 0 或空字符串。
进阶场景下建议：小项目/性能敏感路径用原生绑定；中大型项目且结构体频繁增删字段，选轻量 ORM 并配合编译期校验（如用 static_assert 检查结构体字段数与 INSERT 占位符数量是否一致）。
结构体含 std::string 或 std::vector 怎么安全绑定？
SQLite 只支持基本类型（TEXT、INTEGER、BLOB、REAL、NULL），不能直接 bind std::string 对象。必须传其底层数据指针和长度：
-
sqlite3_bind_text(stmt, 1, my_struct.name.c_str(), my_struct.name.size(), SQLITE_STATIC)—— 注意用SQLITE_STATIC仅当c_str()生命周期长于语句执行；否则用SQLITE_TRANSIENT让 SQLite 自行拷贝 - 对于
std::vector<uint8_t></uint8_t>存二进制数据，用sqlite3_bind_blob(stmt, 2, vec.data(), vec.size(), SQLITE_STATIC) - 千万别写
sqlite3_bind_text(stmt, 1, my_struct.name.c_str(), -1, ...)——-1表示按 \0 截断，而std::string允许含 \0，会导致截断或越界读
如何避免 sqlite3_step() 返回 SQLITE_CONSTRAINT 却没发现主键冲突？
结构体映射到带主键/唯一约束的表时，插入失败常被忽略，因为 sqlite3_step() 返回 SQLITE_CONSTRAINT 而不是错误码，需显式检查：
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
int rc = sqlite3_step(stmt);
if (rc == SQLITE_DONE) {
// 成功
} else if (rc == SQLITE_CONSTRAINT) {
// 主键/唯一冲突，可读取 sqlite3_errmsg(db) 看具体哪一列违规
const char* msg = sqlite3_errmsg(db);
} else {
// 其他错误
}更关键的是：结构体字段顺序必须和 INSERT 语句中 ? 位置严格一致；若结构体加了新字段但忘了更新 SQL 或 bind 顺序，数据会错位写入——比如把 id 写进 name 列，后续查询全乱。
要不要把整个结构体序列化成 JSON 存 BLOB？
可以，但不推荐作为默认方案。JSON BLOB 丧失 SQL 查询能力（无法 WHERE name LIKE '%foo%'），且每次读写都要序列化/反序列化，CPU 开销明显。只在以下情况考虑：
- 结构体嵌套深、字段动态变化（如配置项），且几乎不按字段查询
- 需要跨版本兼容：旧版程序读新版 JSON BLOB 时可跳过未知字段
- 配合 FTS5 做全文检索时，把 JSON 字符串整体塞进虚拟表
真要用，别手写 JSON 拼接，用 nlohmann::json 库转 std::string 后再 bind；同时注意 BLOB 大小限制（默认 1GB，但实际受内存和页大小影响），超限会静默失败或触发 SQLITE_TOOBIG。
最易被忽略的一点：结构体中浮点字段写入 REAL 类型后，从数据库读回可能因精度丢失导致 == 比较失败——别用 double value = sqlite3_column_double(stmt, i) 后直接 if (value == 3.14)，该用误差范围判断。
