用ODB+SQLite实现简单ORM框架，即通过ODB编译器将C++类自动映射为数据库表，生成类型安全的CRUD代码，无需手写SQL或运行时反射，兼顾性能与开发效率。
用 C++ 实现一个“简单 ORM 框架”不等于从零手写完整 ORM（那工作量极大），而是指：用成熟轻量的库（如 ODB）+ SQLite 做数据持久化，以极简方式达成“对象 ↔ 数据库表”的自动映射。下面直接讲清楚怎么做、关键步骤和避坑点。
选 ODB 而不是手撸 ORM 的理由
ODB 是 C++ 领域少有的生产级、无运行时反射、编译期代码生成的 ORM 工具。它不依赖 RTTI 或宏魔法，生成的是纯 C++ 代码，性能高、可调试、兼容标准。相比自己实现序列化 + SQL 拼接 + 类型转换，ODB 省掉 90% 重复逻辑，且天然支持 SQLite、PostgreSQL、MySQL。
注意：ODB 不是头文件库，需安装 + 使用 odb 编译器生成数据库操作代码。
环境准备与最小依赖
确保已安装：
立即学习“C++免费学习笔记（深入）”；
- SQLite3 开发库（含
sqlite3.h和动态/静态库） - ODB 编译器（
odb）及对应 SQLite profile（libodb-sqlite） - C++11 或更高（ODB 2.5+ 推荐 C++14）
Ubuntu 示例：sudo apt install sqlite3 libsqlite3-dev
从 ODB 官网 下载预编译版或源码编译，启用 SQLite profile
定义类并添加 ODB 指令（.h 文件）
比如一个用户类，保存到 user.hxx：
#pragma once #include#include #pragma db object struct user { #pragma db id auto unsigned long id; #pragma db not_null std::string name; #pragma db not_null unsigned int age; };
说明：
-
#pragma db object告诉 ODB 这是个映射类 -
#pragma db id auto表示主键由 SQLite 自增（对应 INTEGER PRIMARY KEY） -
not_null保证字段非空，ODB 会生成约束检查
用 odb 编译器生成数据库代码
在终端执行（假设文件叫 user.hxx）：
odb --sqlite --generate-query --generate-schema user.hxx
会生成 5 个文件：user-odb.hxx, user-odb.ixx, user-odb.cxx, user-odb.sql, user-odb.hpp
其中：
-
.sql是建表语句（可直接执行或嵌入程序） -
.cxx和.hxx是核心操作类（database,transaction,query,result）
把生成的 .cxx 加入项目编译；.hxx 在你的主程序中 #include 即可。
实际使用：增删改查四行代码
主程序示例（main.cpp）：
#include#include #include #include "user-odb.hxx" // 生成的头 int main() { odb::sqlite::database db("test.db"); // 自动创建文件 odb::core::database& db_ref = db; // 插入 user u{0, "Alice", 28}; db_ref.persist(u); // 查询所有 odb::transaction t(db_ref); auto r = db_ref.query (odb::query ::age > 18); for (const auto& x : r) { std::cout << x.name << ", " << x.age << "\n"; } t.commit(); return 0; }
关键点：
- 必须用
odb::transaction包裹读写（SQLite 默认需要显式事务） -
persist()对应 INSERT，load()对应 SELECT BY ID，erase()删除 - 查询用类型安全的
odb::query，不是字符串拼接 SQL
基本上就这些。ODB + SQLite 组合没有魔法，但把 C++ 对象和数据库之间那层胶水做得足够薄、足够稳。不需要懂 SQL 也能做 CRUD，需要复杂查询时，仍可手写原生 SQL 混用。对中小项目或嵌入式场景，这是目前 C++ 最务实的 ORM 落地方式。
