17370845950

最轻量方式是调用 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 和析构包装

#include 
struct 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 导致未定义行为。

• 所有注册函数应优先使用 luabridge::LuaRef 作参数，再在函数体内用 .isNumber()、.isString() 显式判断和转换
• 避免注册返回局部对象引用的函数（如 const std::string&），LuaBridge 不管理其生命周期
• 大量嵌套调用（如 C++ → Lua → C++ → Lua）可能耗尽 Lua 栈，默认栈大小 20，可用 lua_checkstack(L, 50) 扩容

复杂对象交互、异常传播、多线程访问 Lua 状态机，这些地方容易漏掉保护逻辑，得一个个 case 去压测验证。