必须先调用 luaL_openlibs(L) 再 luaL_dofile，否则 print、require 等标准库函数不可用；luaL_dofile 要求脚本路径相对于当前工作目录，失败时错误信息在栈顶，需 lua_tostring(L, -1) 获取并 lua_pop(L, 1) 清理。
怎么用 C++ 加载并执行一个 Lua 脚本文件
直接调用 luaL_dofile 是最简方式，但前提是 Lua 状态机已正确初始化且路径可访问。常见错误是脚本路径不对或当前工作目录与预期不符——Lua 默认按相对路径查找，不是按 C++ 可执行文件位置，也不是按源码位置。
- 先用
luaL_newstate()创建状态机，再用luaL_openlibs()加载标准库（否则print、require都不可用） - 调用
luaL_dofile(L, "main.lua")时，确保"main.lua"在当前进程的工作目录下；不建议硬编码绝对路径，可用getcwd或构建时传入路径参数 - 执行失败时，
luaL_dofile返回非零值，且错误信息留在栈顶，必须用lua_tostring(L, -1)取出并处理，否则栈会持续污染
怎么从 C++ 向 Lua 传递变量（比如 int 或 string）
Lua 栈是核心中介，C++ 所有传参本质都是“压栈 + 调用”。不能直接把 C++ 变量名丢过去，得手动推类型对应值。
- 整数用
lua_pushinteger(L, 123)，浮点用lua_pushnumber(L, 3.14)，字符串用lua_pushstring(L, "hello")（注意：该函数复制字符串，原内存可释放） - 若要让 Lua 脚本能访问全局变量
user_id = 42，需先压值再用lua_setglobal(L, "user_id")；反过来读取则用lua_getglobal(L, "user_id")再配合lua_tointeger(L, -1) - 避免在循环中反复调用
lua_setglobal修改同一变量——Lua 全局表写入有哈希开销，高频场景建议封装为 table 或 userdata
怎么在 C++ 里调用 Lua 中定义的函数
关键在于函数必须在栈上，且参数/返回值严格按栈序管理。漏掉 lua_pop 或栈深错位会导致后续所有调用崩溃。
- 先用
lua_getglobal(L, "my_func")把函数对象推入栈顶；若函数在 table 里（如utils.add），得先lua_getglobal拿到 table，再lua_getfield(L, -1, "add") - 依次用
lua_pushxxx推参数，顺序必须和 Lua 函数签名一致；然后调用lua_pcall(L, argc, retc, 0)，其中retc是期望返回值个数 -
lua_pcall成功后，返回值从栈底往上排布（即最先返回的在栈底）；取完务必用lua_pop(L, retc)清栈，否则下次调用可能读到残留值
为什么 lua_pcall 总是返回 LUA_ERRRUN，但没看到具体错误
因为错误信息默认只留在栈顶，且 lua_pcall 的第四个参数（error handler）为 0 时，不会自动格式化堆栈。你看到的 “attempt to call a nil value” 这类提示，其实是未捕获异常的默认输出，不是 lua_pcall 的返回值内容。
立即学习“C++免费学习笔记（深入）”；
- 检查前先确认函数是否真被成功加载：调用
lua_isfunction(L, -1)，返回 0 说明栈顶不是函数（常见于拼错函数名或未执行lua_getglobal） - 出错后立即用
const char* err = lua_tostring(L, -1)获取错误字符串，之后必须lua_pop(L, 1)，否则栈持续增长 - 如果脚本里用了
require但模块找不到，错误信息会是"module 'xxx' not found"，此时要检查package.path和package.cpath是否已由 C++ 正确设置
C++ 调用 Lua 表面简单，实际容易卡在栈管理、路径解析和错误提取这三个地方。尤其是多线程环境下共用一个 lua_State*，或者反复创建销毁状态机却忘了 lua_close，问题会延迟暴露。
