最轻量方式是调用 luaL_dofile，但需确保 Lua 状态已初始化、路径正确，并检查返回值和栈顶错误信息；LuaBridge 通过 getGlobalNamespace 链式注册类与函数，要求类有默认构造函数，注意类型匹配与生命周期管理。
怎么用 C++ 加载并执行一个 Lua 脚本文件
直接调用 luaL_dofile 是最轻量的方式，但前提是 Lua 状态机已初始化且路径正确。常见错误是脚本路径不对或没处理返回值，导致静默失败。
-
luaL_dofile会自动调用lua_pcall，出错时返回非零值，并把错误信息留在栈顶，必须手动检查 - 相对路径以当前工作目录为准，不是可执行文件所在目录；建议用绝对路径或先用
getcwd拼接 - 如果脚本里有语法错误，
luaL_dofile返回LUA_ERRSYNTAX（值为 2），错误信息在栈顶，需lua_tostring(L, -1)取出
lua_State* L = luaL_newstate();
luaL_openlibs(L);
int result = luaL_dofile(L, "script.lua");
if (result != LUA_OK) {
const char* err = lua_tostring(L, -1);
fprintf(stderr, "Lua error: %s\n", err);
}
lua_close(L);LuaBridge 怎么注册 C++ 类供 Lua 调用
LuaBridge 的核心是 luabridge::getGlobalNamespace，它返回一个命名空间对象，链式调用 beginClass 注册类。注意：类必须有默认构造函数，否则 Lua 实例化会失败。
- 成员函数注册用
addFunction，静态函数用addStaticFunction - 成员变量用
addProperty，但只支持 public 成员或 getter/setter 函数 - 不支持重载函数，同名函数第二次注册会覆盖前一次
- 若类含指针成员或需自定义生命周期管理，必须显式提供
addConstructor和析构包装
#includestruct MyClass { int value = 42; void say() { printf("hello from C++\n"); } }; luabridge::getGlobalNamespace(L) .beginClass ("MyClass") .addConstructor () .addFunction("say", &MyClass::say) .addProperty("value", &MyClass::value) .endClass();
怎么从 Lua 调用 C++ 函数并获取返回值
函数注册后，在 Lua 里像普通函数一样调用即可，但要注意参数类型和返回值匹配。LuaBridge 默认做基本类型转换（int/float/string/bool），但不自动处理 STL 容器或裸指针。
- 若 C++ 函数返回
std::string，Lua 中收到的是 string；返回const char*也转为 string，但内存生命周期需由 C++ 保证 - 传入 Lua table 到 C++，需手动用
luabridge::LuaRef接收，再遍历字段 - 若函数抛异常，LuaBridge 默认不捕获，会导致程序 abort；应在 C++ 函数内用
try/catch包裹并返回错误码或 nil
// C++ 注册
int add(int a, int b) { return a + b; }
luabridge::getGlobalNamespace(L).addFunction("add", add);
// Lua 调用
// local res = add(3, 5) --> res == 8
为什么 LuaBridge 调用 C++ 函数时崩溃或栈溢出
最常见原因是 C++ 函数签名与 Lua 实际传参不一致，比如声明接收两个 int，但 Lua 传了 nil 或 table，LuaBridge 不做运行时类型校验，直接 reinterpret_cast 导致未定义行为。
立即学习“C++免费学习笔记（深入）”；
- 所有注册函数应优先使用
luabridge::LuaRef作参数，再在函数体内用.isNumber()、.isString()显式判断和转换 - 避免注册返回局部对象引用的函数（如
const std::string&），LuaBridge 不管理其生命周期 - 大量嵌套调用（如 C++ → Lua → C++ → Lua）可能耗尽 Lua 栈，默认栈大小 20，可用
lua_checkstack(L, 50)扩容
复杂对象交互、异常传播、多线程访问 Lua 状态机，这些地方容易漏掉保护逻辑，得一个个 case 去压测验证。
