可用lua_pushlightuserdata传递C++对象指针，但需确保对象生命周期长于Lua使用期，配合static包装器调用成员函数，不可直接传成员函数指针，推荐full userdata+__gc管理内存。
如何用 lua_pushlightuserdata 传递 C++ 对象指针给 Lua
不能直接把 C++ 对象指针塞进 Lua 当普通值用，Lua 不认识 C++ 类型，也不管理其生命周期。最轻量、最常用的方式是用 lua_pushlightuserdata 把裸指针（void*）压入栈，再在 Lua 侧存为变量或表字段——它不触发 GC，也不调用元方法，纯粹当个“标记”用。
但必须确保：C++ 对象的生命周期长于 Lua 中对该指针的使用时间，否则访问野指针会崩溃。
- 只适用于已存在、稳定存活的对象（如全局单例、长期持有的资源管理器）
- 不要对栈上对象、临时对象取地址传过去
- 避免跨线程传递，除非你明确控制了同步和析构时机
- 在 Lua 中拿到后，通常要配合自定义的
__index元表来映射方法调用
如何在 Lua 中调用 C++ 成员函数：用 static 包装器 + userdatum 或 light userdata
Lua 的 C API 只能注册 C 风格函数（签名形如 int func(lua_State*)），所以必须写一个 static 成员函数或自由函数作为胶水，从中取出指针、转型、再调用真实方法。
常见模式是：从栈顶取第一个参数（假设是封装了指针的 userdata 或 light userdata），用 lua_touserdata 或 lua_touserdata + 强制转换还原成原始类型，然后调用目标方法。
立即学习“C++免费学习笔记（深入）”；
示例（假设有个 class Foo）：
int lua_Foo_doSomething(lua_State* L) {
// 假设第一个参数是 light userdata 存的 Foo*
Foo* self = static_cast<Foo*>(lua_touserdata(L, 1));
if (!self) return luaL_error(L, "invalid Foo pointer");
self->doSomething(); // 真实调用
return 0;
}- 务必检查指针是否为空，尤其 light userdata 不受 Lua GC 保护，容易被误清或未初始化
- 如果用 full userdata（
lua_newuserdata），可绑定__gc元方法自动析构，但需自行管理内存归属 - 别在包装器里抛 C++ 异常，Lua C API 不捕获它们；改用
luaL_error或返回错误码
为什么不用 lua_pushcfunction 直接传成员函数指针
因为 C++ 成员函数不是 C 函数——它隐含 this 参数，且不同编译器对成员函数指针的二进制表示不一致，无法安全转成 lua_CFunction 类型。
试图强制转换（比如 (lua_CFunction)(void*)&Foo::doSomething）在绝大多数平台会编译失败或运行时崩溃。
-
lua_pushcfunction只接受符合int (*)(lua_State*)签名的函数 - 所有成员函数调用都必须经由 static 包装器中转
- 若需绑定多个对象，包装器里得通过闭包环境（
lua_upvalueindex）或额外参数传 this 指针
最容易忽略的坑：C++ 对象析构后 Lua 还持有指针
这是最隐蔽也最致命的问题。Light userdata 不参与 GC，Lua 完全不知道它背后是个 C++ 对象；full userdata 虽可绑 __gc，但如果你忘了设置元表，或者元表被覆盖，照样泄漏或崩溃。
更麻烦的是：C++ 对象可能被 delete，而 Lua 代码还在调用它的方法——此时不会报“空指针异常”，而是读到随机内存，行为不可预测。
- 强烈建议对关键对象使用 full userdata + 正确
__gc，并在构造时用new分配，在__gc里delete - 若必须用 light userdata，请在 C++ 层加引用计数（如
std::shared_ptr），并提供release接口供 Lua 主动归还 - 调试时可在包装器开头加断言：
assert(self->magic_id == 0x12345678)，提前暴露野指针访问
