必须先调用 luaL_openlibs(L) 再 luaL_dofile，否则标准库函数如 print、require 不可用；Lua 默认状态机不带任何标准库，需显式开启。
用 luaL_dofile 加载脚本前必须先 luaL_openlibs
很多刚接入 Lua 的 C++ 工程师一上来就 luaL_newstate + luaL_dofile，结果脚本报错说 print 未定义或 require 找不到——根本原因是标准库没开。Lua 默认状态机是“裸机”，连 math、string 都不带。
实操建议：
立即学习“C++免费学习笔记（深入）”；
-
luaL_newstate后立刻调用luaL_openlibs(L)，别省这行 - 如果只想要部分库（比如禁用
os和io防止热更脚本删文件），用luaL_requiref单独加载base、table、string等 - 游戏热更场景下，建议显式关闭
os.exit和io.*：在luaL_openlibs后加几行lua_pushnil(L); lua_setglobal(L, "os");
从 C++ 调用 Lua 函数时，栈平衡比返回值更重要
常见错误现象：lua_pcall 返回 0（成功），但后续 lua_getglobal 崩溃，或下一次调用莫名卡住——八成是栈没清干净。Lua C API 是纯栈操作，每 push 一个值，就得对应 pop；函数调用后不清理返回值，栈会越积越多，最终溢出或错位。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 调用前用
lua_getglobal(L, "update")，调用后务必lua_pop(L, 1)（弹出函数本身） - 若函数有返回值，用
lua_pcall(L, 0, 1, 0)表示“期望 1 个返回值”，之后用lua_isnumber(L, -1)检查再lua_pop(L, 1) - 写个 RAII 封装类（如
LuaStackGuard）自动记录初始栈顶，析构时lua_settop(L, top)，比手写pop更可靠
热更新时重载脚本不能只 luaL_dofile，得先清理旧环境
直接反复 luaL_dofile 同一个文件，全局变量不会覆盖，而是叠加。比如脚本里写 g_player_hp = 100，第二次 reload 后变成 200？不，是两次赋值都生效，但只有最后一次写入的值可见——可一旦用了 local + 闭包，或者注册了 C 函数指针到 table，旧引用还在栈里挂着，极易内存泄漏或调用野指针。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 不要复用同一个
lua_State*做热更；每次 reload 新建 state，老 state 异步延迟lua_close - 如果必须复用 state，reload 前执行
lua_getglobal(L, "_G"); lua_getfield(L, -1, "package"); lua_getfield(L, -1, "loaded"); lua_pop(L, 2); lua_pushnil(L); lua_next(L, -2);清空package.loaded缓存 - 给每个热更模块加唯一命名空间 table（如
mygame.player），reload 前lua_getglobal(L, "mygame"); lua_pushnil(L); lua_setfield(L, -2, "player"); lua_pop(L, 1)
C++ 对象传进 Lua 后，生命周期管理稍有不慎就 crash
典型错误：C++ 创建一个 Entity*，用 lua_pushlightuserdata 塞进 Lua，脚本里存到 table 里；C++ 端对象析构了，Lua 还拿着野指针调 entity:takeDamage() —— 直接段错误。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 永远别用
lua_pushlightuserdata传裸指针；改用lua_newuserdatauv+luaL_setmetatable，配合__gc元方法做自动释放 - 如果对象由 C++ 完全控制生命周期（比如 ECS 中的 Component），在 Lua 层只暴露只读访问接口，内部用
void*+uintptr_t包装，并在每次调用前用isValid(entity_id)校验 - 对频繁创建销毁的对象（如子弹），考虑用对象池 + ID 映射，Lua 层只传
intID，C++ 查表取真实指针，避免指针暴露
热更新最麻烦的从来不是语法或调用，而是 C++ 和 Lua 之间那层薄薄的、看不见的生命周期契约。少一个 __gc，晚一秒 lua_close，多一次裸指针传递，都可能让线上玩家突然掉线。
