直接 memcpy 或逐字段 push 会出问题，因会将 padding、未初始化内存、指针地址等错误写入 Lua，导致乱码或 VM 崩溃；C++ 对象生命周期与 Lua GC 不兼容，裸指针传入等于埋雷。
为什么直接 memcpy 或逐字段 push 会出问题
结构体转 Lua table 不是简单把内存 dump 过去，memcpy 会把 padding 字节、未初始化内存、指针地址全塞进 Lua，轻则 table 里出现乱码字段，重则 Lua VM 崩溃（尤其含 std::string 或虚函数表时）。C++ 对象生命周期和 Lua GC 完全不兼容，裸指针传过去等于埋雷。
用 sol2 自动绑定是最稳的路径
sol2 是目前 C++/Lua 互操作最成熟的库，它能自动处理类型映射、内存管理、const 正确性。关键不是“怎么转”，而是“怎么声明可导出结构体”：
- 结构体必须有默认构造函数（哪怕
= default） - 所有字段需为
sol2支持的类型（int、std::string、std::vector<T>等），避免裸指针或FILE* - 注册时用
new_usertype显式列出字段名，不依赖反射（C++17 无标准反射）
示例：
struct Player {
int id = 0;
std::string name;
float hp = 100.0f;
};
lua.new_usertype<Player>("Player",
sol::constructors<Player()>(),
"id", &Player::id,
"name", &Player::name,
"hp", &Player::hp
);
之后在 Lua 里就能直接 local p = Player.new() 或 local t = Player.new():to_table()（需额外写个方法）。
立即学习“C++免费学习笔记（深入）”；
手动 push table 时必须控制字段顺序和类型安全
若不用 sol2（比如嵌入式环境受限），只能手写 lua_createtable + lua_pushxxx，但必须注意：
- 字段名要用
lua_setfield，别用lua_rawseti搞错索引（table 键是 string，不是 array 下标） -
std::string必须用lua_pushlstring（传长度），不能用lua_pushstring（遇 \0 截断） - 嵌套结构体要递归 push，不能只 push 地址——Lua 拿到的是副本，不是引用
- push 完立刻调用
lua_settop(L, -2)清栈，否则栈溢出
错误示范：lua_pushlightuserdata(L, &s.name) —— 这传的是地址，Lua 读出来是垃圾值。
字符串字段和空值处理最容易漏掉
C++ 的 std::string 默认构造为空，但 Lua 的 nil 和空字符串 "" 语义不同；optional<T> 更麻烦，Lua 没原生 optional 类型。常见做法：
- 对
std::optional<int>，存在则 push 值，不存在则lua_pushnil(L) - 对
std::string，统一用!s.empty()判断，而非s.c_str()是否为 null（std::string不会为 null） - 布尔字段别直接 push
int，用lua_pushboolean(L, s.flag)，否则 Lua 里0是 true
没处理空值的代码上线后，Lua 脚本里 if player.name then ... 会意外跳过——因为 C++ 传了空字符串，而 Lua 认为空字符串是 truthy。
真正难的不是语法，是让 C++ 对象的语义在 Lua 里不丢失：padding、生命周期、空状态、嵌套深度。随便一个字段没对齐，table 就多出不可见字段；少清一次栈，下次调用就 crash。
