C++集成Lua核心是通过Lua C API实现双向通信：C++调用Lua函数并读写变量，Lua调用注册的C++函数，关键在于栈操作、类型检查与生命周期管理。
在C++中集成Lua脚本，核心是用Lua C API搭建双向通信桥梁：C++能调用Lua函数、读写Lua变量，Lua也能调用你注册的C++函数。关键不是“绑定框架”，而是理解栈操作、类型检查和生命周期管理。
1. 编译与链接Lua库
从lua.org下载源码（推
荐Lua 5.4），编译为静态库（liblua.a）或动态库（lua.dll / liblua.so）。C++项目需包含lua.h、lualib.h、lauxlib.h头文件，并链接-llua（Linux/macOS）或lua.lib（Windows）。
- Windows下用MSVC：把
lua.h等放入包含目录，链接器输入添加lua.lib - Linux下常用：
g++ main.cpp -llua -ldl -lm（-ldl用于luaL_requiref等动态加载功能） - 确保Lua版本与头文件、库一致，混用5.3头+5.4库会崩溃
2. 基础交互：运行脚本与获取返回值
用luaL_newstate()创建Lua状态机，luaL_dofile()或luaL_dostring()执行脚本。Lua执行结果压入栈顶，用lua_isxxx()判断类型，再用lua_toxxx()取值。
-
lua_getglobal(L, "my_func")把全局函数推入栈 -
lua_pushnumber(L, 123)推入参数 -
lua_pcall(L, 1, 1, 0)调用1个参数、期望1个返回值，错误处理用第4个参数（0表示无错误处理函数） - 调用后栈顶是返回值，用
lua_isnumber(L, -1)检查，double res = lua_tonumber(L, -1)读取，再lua_pop(L, 1)清理
3. 让Lua调用C++函数
写一个符合int func(lua_State* L)签名的C函数，用lua_pushcfunction(L, my_cpp_func)或lua_register(L, "name", my_cpp_func)注册到Lua全局表。函数内用luaL_checkxxx(L, index)安全获取参数，用lua_pushxxx(L, value)返回结果，返回值个数作为函数返回值（如返回1表示压入1个值到栈）。
- 参数索引从1开始：
luaL_checkstring(L, 1)取第1个参数 - 避免裸指针泄漏：若C函数返回C++对象指针，需用
lua_newuserdatauv()+ 元表管理生命周期 - 简单示例：注册
add(a,b)，C函数内用luaL_checkinteger(L,1)+luaL_checkinteger(L,2)计算，lua_pushinteger(L, sum)返回，最后return 1
4. 管理数据与异常
Lua栈是临时的，跨多次lua_pcall不能依赖栈位置；用lua_setglobal()或lua_setfield()把值存进全局表或table字段持久化。错误处理必须用lua_pcall而非lua_call，失败时栈顶是错误信息字符串。
- 查错：调用
lua_pcall后检查返回值，非0则const char* err = lua_tostring(L, -1)获取错误消息 - 避免内存泄漏：每次
lua_newstate()后，务必lua_close(L)释放状态机 - 多线程注意：每个线程应有独立
lua_State*，或加锁共享同一状态机（不推荐）
不复杂但容易忽略。真正卡点常在类型误判、栈溢出、忘记pop、C++对象生命周期与Lua GC不同步——盯住栈平衡和元表设置，就稳了。
