Noita模组开发中自行编译的lua-enet DLL在Steam版运行时加载失败如何解决

问题核心原因定位 #

你遇到的「文件存在但提示找不到模块」是Windows下加载Lua C扩展的常见问题，核心原因基本集中在dll依赖项缺失、导出函数不匹配、运行环境差异三类，按以下步骤逐一排查即可：

排查修复步骤 #

1. 修正编译参数，优先静态链接 runtime 依赖
   你当前的编译命令存在两个问题：

   • 链接参数-lwinm拼写错误，应为-lwinmm
   • 默认动态链接了MinGW runtime库，Steam启动游戏时环境变量没有MinGW的bin目录路径，找不到依赖的libgcc_s_dw2-1.dll、libwinpthread-1.dll等库
     替换为以下编译命令重新编译：

   gcc -O -shared -static -o enet.dll enet.c -lenet -llua5.1 -lws2_32 -lwinmm --verbose
   

   编译完成后直接用enet.dll作为文件名，不要修改为你现在用的长文件名。

2. 修正Lua加载逻辑
   你将dll改名后使用require加载会触发Lua的入口函数匹配规则：require("xxx")会强制查找名为luaopen_xxx的导出函数，你编译的dll默认导出的是luaopen_enet，和你改后的长文件名完全不匹配，自然加载失败。
   把你代码里的加载逻辑替换为以下内容即可：

   -- 前面的package.path、package.cpath配置保留
   local enet_lib = package.loadlib("mods/noita-mp/files/libs/enet.dll", "luaopen_enet")
   if not enet_lib then
       error("加载enet.dll失败：" .. tostring(enet_lib))
   end
   local enet = enet_lib()
   

3. 排查依赖项缺失（可选，如上述步骤未解决）
   用Dependencies工具打开你编译的enet.dll，查看所有依赖项是否都能被正常找到，把缺失的dll和enet.dll放在同一目录即可。
   也可以用Process Monitor工具过滤Noita.exe的文件操作事件，查看加载dll时具体是哪个依赖项找不到。

4. 排除Steam环境干扰
   打开Steam库，右键Noita选择「属性」，在「通用」分页取消勾选「启用Steam界面」，关闭游戏内覆盖后再启动测试。

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