Lua C API 手动绑定最底层灵活但需手写胶水代码，易因栈清理遗漏、类型未检、元表缺失出错；sol2 简洁高效但需禁用异常、注册类型、隔离线程；Python 嵌入成本高不推荐；热重载须自行监控文件并清理缓存与沙盒。
用 Lua C API 手动绑定最可控
直接裸调 lua_pushcfunction、lua_setglobal 是最底层也最灵活的方式，适合需要精确控制生命周期、参数检查或错误传播的场景。它不依赖第三方库，编译即用，但每绑一个函数都要写胶水代码。
常见错误是忘记调用 lua_pop 清理栈，或在 C++ 函数里用 lua_tostring 时没先用 lua_isstring 检查类型，导致崩溃；还有把 this 指针存进 Lua 表后没设元表，后续调用 -> 方法时找不到 __index。
- 绑定成员函数前，先用
lua_pushlightuserdata把this压栈，再用lua_pushcclosure封装成闭包 - 导出类时，用
luaL_newmetatable创建元表，设置__index指向方法表，__gc做析构清理 - 所有从 Lua 取值的操作，必须加类型判断（如
if (!lua_isnumber(L, 1)) return luaL_error(L, "expected number")）
sol2 能大幅减少样板代码
sol2 是目前 C++ 绑定 Lua 最主流的头文件库，语法简洁，支持自动类型推导、重载解析和智能指针，但要注意它默认启用异常——而 Lua 本身不抛 C++ 异常，一旦 C++ 层 throw，会直接 abort。
典型踩坑点：绑定返回 std::shared_ptr<t></t> 的函数时，如果没提前用 sol::usertype 注册 T，运行时调用会报 "attempt to index a nil value"；还有在多线程环境里共享一个 sol::state 实例，没加锁就并发 script()，导致栈错乱。
立即学习“C++免费学习笔记（深入）”；
- 禁用异常：构造
sol::state时传sol::state_view(sol::c_call, sol::no_exception) - 绑定类前先注册其基类和智能指针类型：
lua.new_usertype<base>("Base", ...); lua.new_usertype<derived>("Derived", sol::base_classes, sol::bases<base>());</derived> - 避免跨线程复用同一
sol::state；若需多线程，每个线程持有一个独立实例
Python 嵌入不是替代方案
有人想用 Python 替代 Lua 做脚本绑定，但 CPython 的嵌入成本远高于 Lua：启动慢、内存占用大、GIL 导致无法真正并行执行脚本逻辑，且 PyBind11 绑定后对象生命周期管理更难对齐。除非已有 Python 生态强依赖，否则纯属增加复杂度。
实际测试中，同等功能下，Lua 启动 sol::state 平均耗时 0.3ms，CPython 初始化 Py_Initialize + pybind11::module_::import 超过 8ms；且 Lua 字符串操作、表遍历等基础性能稳定高出 2–3 倍。
- 不要因为熟悉 Python 就强行替换——脚本语言选型要看嵌入轻量性、启动延迟、调试便利性，而非语法习惯
- 如果真要用 Python，务必用
PyThreadState_Swap管理线程状态，且禁止在回调中调用任何可能触发 GC 的操作
热重载必须自己接管文件监控
Lua 本身不提供文件变化监听，dofile 或 require 都只是加载一次。要实现脚本热重载，得在 C++ 层用 inotify（Linux）、ReadDirectoryChangesW（Windows）或 FSEvents（macOS）监听 .lua 文件变更，再手动 luaL_loadfile + lua_pcall 重新执行。
容易忽略的是模块缓存：Lua 把已加载模块存在 package.loaded 表里，不清理会导致新代码不生效。另外，如果脚本里定义了全局变量或修改了已有 table，直接 reload 会污染状态，必须做沙盒隔离。
- 每次 reload 前清空
package.loaded["mymodule"]，并用lua_getglobal(L, "package"); lua_getfield(L, -1, "loaded"); lua_pushnil(L); lua_setfield(L, -3, "mymodule"); - 用
lua_newthread为每个脚本创建独立协程，配合自定义lua_Alloc控制内存域，避免 reload 时影响主线程栈 - 别依赖 IDE 自动保存触发重载——编辑器保存时机和你的监听回调可能有竞态，加 100ms 去抖
