如何在C++的Lua回调函数间共享数据（非全局/单例方式）

如果你不想用全局变量或单例，有两种可靠的方式把数据和lua_State绑定，让回调函数能安全访问：

方法1：利用Lua注册表存储单值数据 #

每个lua_State都自带一个私有注册表，专门用来存C++和Lua交互的关联数据，不会和全局变量冲突。

代码示例 #

// 唯一注册表键，用自定义命名空间避免冲突
static const char* kTotalCallsKey = "com.example.total_set_param_calls";

static int SetParam(lua_State *state) {
    // 从注册表取出数据指针
    lua_getfield(state, LUA_REGISTRYINDEX, kTotalCallsKey);
    long* pTotalCalls = static_cast<long*>(lua_touserdata(state, -1));
    lua_pop(state, 1); // 弹出栈上的用户数据，保持栈平衡

    if (pTotalCalls) {
        ++(*pTotalCalls);
    }
    return 0; // Lua回调返回值数量
}

// 业务代码
long nTotalSetParamCalls = 0L;
lua_State* m_luaState = luaL_newstate();
luaL_openlibs(m_luaState);

// 将数据指针存入注册表
lua_pushlightuserdata(m_luaState, &nTotalSetParamCalls);
lua_setfield(m_luaState, LUA_REGISTRYINDEX, kTotalCallsKey);

lua_register(m_luaState, "SetParam", SetParam);
luaL_dostring(m_luaState, "SetParam() SetParam()"); // 示例脚本调用两次

std::cout << "SetParam was called: " << nTotalSetParamCalls << " times" << std::endl;

lua_close(m_luaState);

方法2：给lua_State附加自定义状态结构体 #

如果需要共享多个数据，推荐把所有数据打包成一个结构体，再关联到lua_State，结构更清晰。

代码示例 #

// 自定义状态结构体，包含所有需要共享的数据
struct LuaStateData {
    long nTotalSetParamCalls = 0L;
    // 可扩展其他字段，比如配置参数、业务对象指针等
};

static const char* kStateDataKey = "com.example.lua_state_data";

static int SetParam(lua_State *state) {
    // 取出自定义状态
    lua_getfield(state, LUA_REGISTRYINDEX, kStateDataKey);
    LuaStateData* pData = static_cast<LuaStateData*>(lua_touserdata(state, -1));
    lua_pop(state, 1);

    if (pData) {
        ++pData->nTotalSetParamCalls;
    }
    return 0;
}

// 业务代码
lua_State* m_luaState = luaL_newstate();
luaL_openlibs(m_luaState);

// 创建并初始化自定义状态（堆分配，记得后续释放）
LuaStateData* pStateData = new LuaStateData();
lua_pushlightuserdata(m_luaState, pStateData);
lua_setfield(m_luaState, LUA_REGISTRYINDEX, kStateDataKey);

lua_register(m_luaState, "SetParam", SetParam);
luaL_dostring(m_luaState, "for i=1,5 do SetParam() end"); // 调用5次

std::cout << "SetParam was called: " << pStateData->nTotalSetParamCalls << " times" << std::endl;

// 清理资源
delete pStateData;
lua_close(m_luaState);

关键注意事项 #

• 生命周期匹配：关联的数据要保证在lua_State运行期间不会被销毁。栈上变量要确保其作用域覆盖Lua状态的使用周期；堆上变量要在关闭lua_State前手动释放，避免内存泄漏。
• 键唯一性：注册表键建议用带命名空间的字符串（如公司域名+模块名），防止和其他第三方库的键冲突。
• 栈平衡：回调函数中操作Lua栈后，要及时弹出不需要的元素，避免栈溢出或后续操作出错。

内容的提问来源于stack exchange，提问作者marukas