C++如何与Lua交互？C++嵌入Lua脚本引擎教程【混合编程】

C++嵌入Lua核心是纯C API操作栈：初始化状态机并加载脚本；C++调用Lua函数需压参、pcall、取返回值；注册C函数供Lua调用；用userdata封装复杂数据并配元表；全程注意栈平衡。

用C++嵌入Lua，核心是调用Lua C API完成栈操作、函数调用和数据交换。不依赖第三方绑定库（如sol2或LuaBridge），纯C API方式最轻量、最可控，也最能帮你理解底层交互逻辑。

一、初始化Lua环境并加载脚本

先链接lua5.4.lib（或对应版本）并包含头文件lua.hpp（或分开包含lua.hlauxlib.hlualib.h）。创建Lua状态机是第一步：

• 调用luaL_newstate()获得lua_State*指针，这是整个Lua世界的入口
• 用luaL_openlibs(L)加载标准库（print、string、table等才可用）
• 加载脚本有三种常用方式：luaL_dostring(L, "print('hello')")（字符串）、luaL_loadfile(L, "main.lua") + lua_pcall（文件）、luaL_loadbuffer（内存块）

二、C++调用Lua函数

前提是Lua函数已存在（全局或放在table里），调用过程本质是“压参→调用→取返回值”，全程操作Lua栈：

• 用lua_getglobal(L, "add")把全局函数add压入栈顶
• 用lua_pushnumber(L, 10)、lua_pushnumber(L, 20)依次压入参数（顺序即调用顺序）
• 调用lua_pcall(L, 2, 1, 0)：2个参数、期望1个返回值、无错误处理函数
• 调用后栈顶是返回值，用lua_isnumber(L, -1)判断类型，再用lua_tonumber(L, -1)取出，最后lua_pop(L, 1)清理

三、Lua调用C++函数（注册C函数）

让Lua能直接调用C++逻辑，需把C函数注册为Lua全局函数或table成员。注意：C函数签名固定为int func(lua_State* L)，返回值是“推入栈的返回值个数”：

• 写一个C风格函数，例如int l_print_time(lua_State* L) { time_t t = time(nullptr); lua_pushnumber(L, (double)t); return 1; }
• 注册到全局：lua_register(L, "os_time", l_print_time)，之后Lua中就能写print(os_time())
• 若想注册进table（如mylib），先创建table（lua_newtable(L)），再用lua_pushcfunction+lua_setfield设字段

四、在C++和Lua间传递复杂数据（table、string、userdata）

基础类型（number/string/boolean）直接用lua_pushxxx/lua_toxxx；结构体或对象建议用userdata封装，配合元表实现面向对象风格：

• 创建userdata：MyClass* obj = (MyClass*)lua_newuserdata(L, sizeof(MyClass)); new(obj) MyClass();
• 设置元表（定义__index、__gc等）：luaL_newmetatable(L, "MyClass"); lua_setmetatable(L, -2);
• 从Lua读取table字段：先lua_getfield(L, -1, "name")，再lua_tostring，记得lua_pop清理栈
• 向Lua返回table：用lua_createtable(L, 0, 2)，然后lua_pushstring+lua_setfield设键值对

基本上就这些。栈平衡是关键——每次push要配对pop，函数调用前后栈深差应等于参数个数减返回个数。多练几个小例子（比如传数组、调用带callback的C函数），很快就能上手。