c++如何集成Lua脚本引擎_c++ sol2/LuaBridge使用教程【扩展性】

sol2和LuaBridge是C++集成Lua的两大主流绑定库：sol2功能全、现代易用，适合中大型项目；LuaBridge极简零开销，适合资源受限场景。

在 C++ 项目中集成 Lua 是提升扩展性与热更新能力的常用手段，sol2 和 LuaBridge 是目前最主流的两个轻量、现代、易用的绑定库。它们都基于 Lua C API，但大幅简化了类型映射、函数注册和对象生命周期管理。核心目标不是“让 Lua 跑起来”，而是“让 C++ 和 Lua 自然地互相调用、共享数据、协同工作”。

为什么选 sol2 或 LuaBridge？

两者都支持 C++14+，无需预编译或代码生成，头文件即用（header-only），无额外依赖。区别在于设计哲学：

• sol2：更现代、功能更全（如协程、元表操作、多返回值、完美转发），API 风格接近 C++ 标准库，文档丰富，社区活跃；适合中大型项目或需要深度 Lua 控制的场景。
• LuaBridge：极简、零开销、无模板膨胀，编译快，内存模型透明；适合嵌入式、对二进制体积/启动时间敏感，或只需基础函数/类暴露的轻量需求。

sol2 快速集成示例（C++ 暴露函数与类）

只需引入 sol.hpp（单头文件），确保链接 lua5.4（或对应版本）库：

#include <sol/sol.hpp>
#include <iostream>
<p>int add(int a, int b) { return a + b; }</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/6e7abc4abb9f" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">C++免费学习笔记（深入）</a>”；</p><p>struct Vec2 {
float x = 0, y = 0;
Vec2(float x<em>, float y</em>) : x(x<em>), y(y</em>) {}
float len() const { return std::sqrt(x<em>x + y</em>y); }
};</p><p>int main() {
sol::state lua;
lua.open_libraries(); // 启用标准库（base, table, string...）</p><pre class="brush:php;toolbar:false;">// 暴露普通函数
lua.set_function("add", add);

// 暴露类（自动处理构造、成员函数、属性）
lua.new_usertype<Vec2>("Vec2",
    sol::constructors<Vec2(float, float)>(),
    "x", &Vec2::x,
    "y", &Vec2::y,
    "len", &Vec2::len
);

// 执行 Lua 脚本
lua.script(R"(
    local v = Vec2(3, 4)
    print("length:", v:len()) -- 输出: length: 5
    print("sum:", add(10, 20)) -- 输出: sum: 30
)");

return 0;

登录后复制

}

标签： c++ lua ai ios stream 区别 标准库 yy 为什么