C++与Lua互调原理及完整示例详解

核心运行机制

从本质上讲，并不存在独立的“C++调用Lua”或“Lua调用C++”概念。Lua是一个运行在C语言之上的轻量级引擎，其源代码会被编译成特定的字节码（Bytecode）。所谓的互操作，实际上是C/C++程序对Lua字节码的解释执行，或是Lua字节码解析过程中对C函数指针的回调调用。

当C++调用Lua时，系统会对Lua源码进行词法与语法分析，生成闭包并推入虚拟机栈中等待运行。当Lua需要调用C++功能时，它实际上是在解释运行包含调用指令的字节码，并在运行时去查找注册在全局环境中的C函数闭包进行执行。

互调用代码示例

以下演示一个完整的Hello World级别示例：C++创建一个Lua状态机，加载一段Lua脚本；该脚本调用由C++注册的全局加法函数，并最终打印结果。

第1步：定义并注册C++原生函数

C++函数需要通过特定的签名接入Lua虚拟机栈（lua_State*）。在此步骤中，定义一个求和函数，并从栈顶获取参数，将结果压回栈中供Lua返回。

#include <cstdio>
#include "Inc/lua.h"
#include "Inc/lauxlib.h"
#include "Inc/lualib.h"

// C++函数签名为 int (lua_State* L)，接收虚拟机的指针
int CAdd(lua_State* L)
{
	// 注意：Lua栈索引从1开始
	int a = lua_tonumber(L, 1);
	int b = lua_tonumber(L, 2);
	int sum = a + b;
	
	// 将计算结果压入栈顶，Lua调用者将从此处获取返回值
	lua_pushnumber(L, sum);
	return 1; // 指示返回值的数量为1个
}

int main()
{
	// 初始化Lua虚拟机状态
	lua_State* L = luaL_newstate();
	// 打开标准库
	luaL_openlibs(L);

	// 将C++函数绑定到Lua全局变量名 "CAdd"
	lua_register(L, "CAdd", CAdd);
	
	// ... 后续加载脚本等逻辑 ...
}

第2步：加载并执行Lua脚本

使用 luaL_loadfile 配合 lua_pcall 进行安全的加载和执行。如果加载成功，脚本中的 CAdd(1, 2) 将会触发上述注册的C函数。

local x = CAdd(1, 2)
print("x = " .. tostring(x))

C++端主要执行流如下：

// 编译并检查错误
int stat = luaL_loadfile(L, "Test.lua") | lua_pcall(L, 0, 0, 0);
if (stat)
{
	std::cout << "error" << std::endl;
	// Lua错误通常会保留在栈顶，可通过lua_tostring(L, -1)获取详情
} else {
	std::cout << "succ" << std::endl;
}
lua_close(L);