萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Linux 下編寫 Lua C 擴展 (.so) 完整實戰:從 C 代碼到 Lua 調用

編寫 Lua C 擴展是提升性能、訪問系統底層接口的標準路徑。本文提供最小化完整示例:C 代碼實現 math.sin 封裝、Makefile 編譯 .so、Lua 腳本加載調用,涵蓋所有關鍵細節。

C 源碼:mylibs.c

#include 
#include 
#include 
#include "lua.h"
#include "lualib.h"
#include "lauxlib.h"

/* 庫打開函數前置聲明 */
int luaopen_mylib(lua_State *L);

/* 實現:lua 中調用 mylib.lsin(x) 返回 math.sin(x) */
static int l_sin(lua_State *L) {
    double d = luaL_checknumber(L, 1);  // 取第 1 參數,類型檢查
    lua_pushnumber(L, sin(d));          // 壓入結果
    return 1;                           // 返回值個數
}

/* 方法註冊表:{lua名, C函數}, 以 {NULL,NULL} 結尾 */
static const luaL_Reg mylib[] = {
    {"lsin", l_sin},
    {NULL, NULL}
};

/* 模塊打開函數:註冊庫表並返回 */
int luaopen_mylib(lua_State *L) {
    luaL_register(L, "mylib", mylib);  // Lua 5.1 風格
    return 1;
}

/* 關鍵:若為 .cpp 文件,必須加 extern "C" 防止名字修飾
extern "C" int luaopen_mylib(lua_State *L); */

編譯為 .so

手動編譯命令

gcc mylibs.c -fPIC -shared -o libmylib.so -llua -lm
  • -fPIC:生成位置無關代碼(共享庫必須)。
  • -shared:生成共享庫。
  • -llua -lm:鏈接 Lua 庫和數學庫。

Makefile

CXX = gcc
LIBNAME = libmylib.so
SRC = mylibs.c
OBJ = $(SRC:.c=.o)

all: $(LIBNAME)

$(LIBNAME): $(OBJ)
	$(CXX) -shared -o $@ $^ -llua -lm

%.o: %.c
	$(CXX) -fPIC -c -Wall $< -o $@

clean:
	rm -f *.o *.so

Lua 調用腳本

-- 加載動態庫並獲取模塊表
local mylib = package.loadlib("libmylib.so", "luaopen_mylib")()
-- 等價於: local mylib = require("mylib")  (需將 .so 放在 package.cpath 路徑下)

print(mylib.lsin(10))  -- 輸出: -0.54402111088937

關鍵點總結

  1. 模塊名與打開函數對應:luaopen_mylib 對應 require "mylib",文件名通常為 libmylib.so 或 mylib.so。
  2. 棧操作規範:參數從棧底向上索引 (1,2,...);返回值壓入棧頂,返回值個數作為 C 函數返回值。
  3. 類型檢查:luaL_checknumber、luaL_checkstring、luaL_checkinteger 等,錯誤時自動拋出 Lua 錯誤。
  4. 錯誤傳播:C 函數內調用 luaL_error(L, "msg") 拋出 Lua 異常。
  5. C++ 混編:extern "C" 修飾打開函數,避免符號修飾導致 require 找不到符號。

調試技巧

  • 編譯加 -g,用 gdb --args lua test.lua 調試 C 代碼。
  • LD_DEBUG=libs lua test.lua 觀察動態庫加載過程。
  • Lua 5.2+ 用 luaL_newlib 替代 luaL_register,返回表而非壓棧。

掌握 Lua C 擴展開發流程,讓你在性能熱點、系統接口、現有 C 庫復用等場景游刃有餘。

copyright © 萬盛學電腦網 all rights reserved