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++免费学习笔记（深入）”；
- 写一个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函数），很快就能上手。
