sol2是目前嵌入Lua最省心的选择，因其头文件即用、无需运行时依赖、错误提示清晰，且比luabind更现代稳定、比V8/QuickJS更轻量易用。
用 sol2 嵌入 Lua 是目前最省心的选择
如果你只是想让 C++ 调用脚本逻辑、暴露少量类和函数，又不想自己写解析器或维护 VM，sol2 是当前事实标准。它不是“最轻量”的（体积约几百 KB 源码），但“轻量级”在这里的真实含义是：不改构建流程、不引入运行时依赖、头文件即用、错误提示可读。
常见错误现象：sol::state 构造后直接调用 script() 报 attempt to call a nil value——通常是因为没调用 open_libraries()，Lua 标准库（如 print、table）默认不加载。
- 必须在
sol::state实例化后立刻调用.open_libraries()，否则连print都不能用 - 暴露 C++ 类时，用
new_usertype<MyClass>()，别手写lua_pushcfunction——后者容易漏掉元表设置，导致obj.method()调用失败 - 避免在 Lua 中长期持有 C++ 对象裸指针；用
sol::object或sol::userdata管理生命周期，否则易出现 use-after-free
sol2 和 luabind 选哪个？
luabind 已多年未更新，C++17 下编译失败率高，且错误信息全是模板深渊；sol2 主动适配 Clang/GCC/MSVC 各版本，对 constexpr、auto、结构化绑定支持良好。性能上两者差距不大，但 sol2 的 API 更贴近直觉：比如注册重载函数，sol2 允许直接传多个 lambda，luabind 得靠宏或手动分发。
-
sol2默认启用异常捕获（sol::call_error可捕获脚本异常），luabind默认把 Lua error 当 abort - 若项目已用 CMake，
sol2只需add_subdirectory()或find_package(sol2)，无额外构建步骤；luabind依赖 Boost.Python 风格的构建系统，容易卡在 Python 版本或 bjam 上 - 兼容性注意：
sol2v3 要求 C++17，v4 开始要求 C++20；若还在用 C++14，得锁死用 v2.20.6
如何安全地从 Lua 回调 C++ 函数并传参？
核心原则：别让 Lua 持有 C++ 栈变量地址，也别在回调里直接用 this 指针（除非你 100% 确保对象生命周期长于脚本执行）。最稳妥的是用 std::shared_ptr 包裹对象，再通过 sol::set_function 注入。
立即学习“C++免费学习笔记（深入）”；
auto state = sol::state{};
state.open_libraries();
auto obj = std::make_shared<MyService>();
state.set_function("handle_event", [obj](int code, const std::string& msg) {
obj->on_event(code, msg); // 安全：obj 生命周期由 shared_ptr 保证
});
state.script("handle_event(42, 'done')");
- 如果回调参数含自定义类型（如
Vec3），必须提前注册该类型，否则sol2解包失败时静默转成nil，不易察觉 - 避免在回调中调用
state.script()——嵌套脚本执行可能触发重入，而sol::state不是线程安全的；如需动态执行，应另起独立sol::state - 参数类型不匹配时，
sol2默认抛sol::error异常；若关闭异常（sol::no_error_handler），会返回sol::nullopt，需手动检查
为什么不用 V8 或 QuickJS？
它们不是“太重”，而是“重得不匹配”。V8 编译产物超 20MB，启动耗时几十毫秒，还要处理 isolate、context、handles——仅为了跑几行配置逻辑或事件响应，属于典型的大炮打蚊子。QuickJS 更轻，但 C++ 绑定生态几乎为零，所有类型转换、异常映射、GC 交互都得自己写。
- V8 的
v8::Isolate::New()在某些嵌入式环境（如 iOS App Extension）会被系统限制，而 Lua +sol2完全无此问题 - QuickJS 的
JS_Eval()返回的是原始JSValue，要取字符串得手动调JS_ToCString()再JS_FreeCString()，漏一次就内存泄漏；sol2的sol::object自动管理引用计数 - 调试体验差：QuickJS 错误只有
JS_ThrowReferenceError这类底层提示；sol2的错误消息会带 Lua 行号和 C++ 函数签名，定位快得多
真正容易被忽略的点是：脚本引擎的“轻量”不只看二进制大小，更看集成成本、调试反馈速度、以及出错时你能否在 30 秒内定位到是语法错、类型错还是生命周期错。这些地方，sol2 交的答卷目前最均衡。
