如何使用sol2（sol 3）实现等价于纯C的Lua C++模块？

要实现和纯C中luaL_newlib导出luaopen_mymodule等价的Lua模块，用sol2可以更简洁地完成，核心是导出符合Lua规范的luaopen_*函数，同时用sol2的API构建模块表。

实现步骤 #

1. 引入sol2头文件
   确保项目能访问sol2头文件，直接包含即可：

   #include <sol/sol.hpp>
   

2. 定义模块功能函数
   支持两种风格的函数：纯C风格的Lua栈操作函数，或是更贴合C++的自动栈转换函数：

   // C风格栈操作函数
   static int add(lua_State* L) {
       sol::stack_table args(L);
       int a = args[1];
       int b = args[2];
       sol::stack::push(L, a + b);
       return 1;
   }
   
   // C++风格函数，sol2自动处理Lua栈的参数与返回值转换
   static std::string greet(const std::string& name) {
       return "Hello, " + name + "!";
   }
   

3. 导出luaopen_mymodule入口函数
   这个函数是Luarequire时的调用入口，必须用extern "C"修饰以避免C++名字修饰：

   extern "C" int luaopen_mymodule(lua_State* L) {
       // 绑定到传入的Lua栈，创建状态视图
       sol::state_view lua(L);
       // 创建模块表，等价于luaL_newlib的函数表
       sol::table module = lua.create_table();
   
       // 向模块表添加函数与变量
       module["add"] = add;
       module["greet"] = greet;
       module["version"] = "1.0.0";
   
       // 将模块表压入栈顶，返回1表示栈上有一个返回值（模块表）
       module.push();
       return 1;
   }
   

编译与使用 #

• 编译为动态库
  用g++编译时需指定共享库参数，链接对应版本的Lua库：

  g++ -shared -fPIC mymodule.cpp -o mymodule.so -I/path/to/sol2/include -llua5.4
  

  替换/path/to/sol2/include为你的sol2头文件路径，lua5.4为实际使用的Lua版本库名。

• 在Lua中调用
  将生成的.so（Windows下为.dll）放到Lua可检索的路径，直接通过require加载：

  local mymodule = require("mymodule")
  print(mymodule.add(2, 3))       --> 5
  print(mymodule.greet("Bob"))    --> Hello, Bob!
  print(mymodule.version)         --> 1.0.0
  

进阶简化写法 #

可以用sol2的sol::module辅助类更快捷地定义模块：

extern "C" int luaopen_mymodule(lua_State* L) {
    sol::state_view lua(L);
    sol::table module = sol::module(lua, "mymodule");
    module["add"] = add;
    module["greet"] = greet;
    module["version"] = "1.0.0";
    return module.push();
}

内容的提问来源于stack exchange，提问作者fghzxm