lua_getglobal压入全局变量值后必须用lua_isfunction(l, -1)检查栈顶是否为函数，否则若目标未定义或被赋nil，后续lua_pcall会因“attempt to call a nil value”失败。
lua_getglobal 之后必须检查栈顶是否为函数
调用 Lua 全局函数前，得先把它压到栈顶，lua_getglobal 就是干这事的。但它不验证目标名是否存在——如果脚本里没定义那个函数，lua_getglobal 仍会成功压入 nil，后续 lua_pcall 就会报错 "attempt to call a nil value"。
实操建议：
- 调用
lua_getglobal(L, "func_name")后，立刻用lua_isfunction(L, -1)检查栈顶类型 - 若返回
0，说明函数不存在或被覆盖（比如被赋值为 number/string），应提前报错退出 - 别依赖
lua_pcall的错误信息来定位“函数未定义”问题，那已经是第二道防线了
参数压栈顺序和 lua_pcall 的 nargs 参数要对齐
Lua C API 要求参数从左到右依次压栈，**函数本身在栈底，参数紧随其后**；而 lua_pcall 的 nargs 参数必须精确等于你压入的参数个数（不含函数本身）。
常见错误现象：
- 少压一个参数 →
lua_pcall报"wrong number of arguments" - 多压一个（比如误把函数又压了一次）→ 函数体内
...拿到错误的arg表，或触发栈溢出 - 参数类型不匹配（如传 int 给期待 string 的函数）→ 运行时报错，但 C 层看不到具体 Lua 错误位置
示例：调用 add(a, b)：
lua_getglobal(L, "add");
lua_pushinteger(L, 10);
lua_pushinteger(L, 20); // 两个参数，nargs = 2
if (lua_pcall(L, 2, 1, 0) != LUA_OK) {
fprintf(stderr, "Error: %s\n", lua_tostring(L, -1));
}
处理返回值前务必检查 lua_pcall 返回值
lua_pcall 成功时返回 LUA_OK，失败时返回错误码（如 LUA_ERRRUN），且**错误信息会留在栈顶**。如果忽略返回值直接调 lua_tonumber(L, -1)，可能取到错误信息字符串，导致静默转换为 0 或 NaN。
关键点：
- 永远用
if (lua_pcall(...) != LUA_OK)判断，不要只看是否为 0 - 失败时，栈顶是错误字符串，记得用
lua_pop(L, 1)清理，否则下次调用可能栈错位 - 成功时，返回值从栈顶开始向下排布（-1 是最后一个返回值），数量由
lua_pcall的nresults参数决定
注意 Lua 状态机生命周期和线程安全
多个 C++ 线程共用同一个 lua_State* 是危险的——Lua 5.4 之前默认非线程安全，即使加锁也容易因 GC、hook 或协程导致不可预测行为。
稳妥做法：
- 每个线程独占一个
lua_State*，初始化时用luaL_newstate()创建，结束时lua_close() - 若需共享数据，走 C++ 层中转（如全局 map + mutex），而不是在 Lua 中用全局表跨线程读写
- 避免在
lua_pcall中调用可能阻塞或切换线程的 C++ 函数（比如带 mutex lock 的回调），否则可能死锁
复杂点在于：Lua 函数内部可能调用其他 C 函数，那些 C 函数再间接触发新线程操作——这种嵌套调用链里，栈状态和状态机归属很容易被忽略。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
