Lua 5.4 与 GCC 动态链接时出现未定义引用问题求助

问题重现 #

代码：

#include <stdlib.h>

#include <lua.h>
#include <lualib.h>
#include <lauxlib.h>

int main(void)
{
    lua_State *state = luaL_newstate();
    lua_close(state);
    return 0;
 }

编译命令：

cls && gcc test.c -Ilua-5.4.2_Win64_dllw6_lib\include -Llua-5.4.2_Win64_dllw6_lib -llua54

尝试过静态链接（-l:liblua54.a）、调整参数顺序、移动文件到MinGW64的include/lib目录，均未解决未定义引用问题。

核心原因及解决方案 #

1. 库文件兼容性问题 #

你使用的lua-5.4.2_Win64_dllw6_lib大概率是MSVC编译版本，和MinGW的GCC生成的目标文件不兼容，导致链接时找不到符号。

解决：下载或编译MinGW版本的Lua库：

• 下载Lua 5.4.2源码包，解压进入src目录
• 打开MinGW终端，执行编译命令：

  make mingw
  

• 编译完成后，src目录会生成liblua.a（静态库）、lua54.dll（动态库）和lua.exe，将头文件（lua.h、lualib.h等）、库文件整理到项目目录的对应位置。

2. 调整编译命令参数顺序 #

GCC要求库参数必须放在源文件之后，否则链接器无法正确匹配符号。正确的编译命令示例：

gcc test.c -Ilua-5.4.2-mingw\include -Llua-5.4.2-mingw\lib -llua54

（替换路径为你自己的MinGW编译后的Lua库路径）

3. 动态链接的DLL路径问题 #

编译成功后运行程序时，需将lua54.dll放到以下位置之一：

• 与生成的exe文件同目录
• 添加到系统PATH环境变量中

否则会提示找不到动态链接库。

4. 静态链接的正确姿势 #

如果使用静态库，需添加-static参数，确保链接静态库而非动态库：

gcc test.c -Ilua-5.4.2-mingw\include -Llua-5.4.2-mingw\lib -static -llua54

额外排查步骤 #

• 检查头文件路径：确保-I指定的目录下存在lua.h、lauxlib.h等文件
• 验证库文件符号：用nm命令查看库中是否包含目标符号（以静态库为例）：

  nm lua-5.4.2-mingw\lib\liblua.a | grep luaL_newstate
  

  如果输出包含T luaL_newstate，说明符号存在且可被链接。

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