使用lime（haxeflixel）编译FNF时出现Haxe Type not found报错求助

报错表现 #

编译时控制台输出如下错误：

source/LuaClass.hx:3: characters 8-20 : Type not found : llua.Convert
source/LuaClass.hx:4: characters 8-16 : Type not found : llua.Lua
source/LuaClass.hx:5: characters 8-18 : Type not found : llua.State
source/LuaClass.hx:6: characters 8-17 : Type not found : llua.LuaL

产生原因 #

• 项目依赖的llua（Haxe语言的Lua绑定库）未正确安装
• 拉取项目时未同步拉取llua子模块，大部分FNF mod会将该库作为git子模块放在项目依赖目录
• 项目配置文件中未正确引入llua依赖，或Haxe全局库路径下缺少对应版本的llua库

排查修复步骤 #

• 同步项目子模块
  进入项目根目录执行子模块更新命令，拉取所有依赖的子模块源码：

  git submodule update --init --recursive
  

  执行完成后检查项目lib/目录下是否存在llua文件夹，确认内部源码文件完整。
• 手动安装llua依赖
  如果子模块拉取后仍报错，可以通过haxelib全局安装llua库：

  haxelib install llua
  

  安装完成后打开项目根目录的project.xml文件，确认存在如下配置：

  <haxelib name="llua" />
  

• 检查路径配置
  确认LuaClass.hx头部的import语句没有拼写错误，llua库的目录层级和import路径匹配。
• 清理缓存重新编译
  所有配置调整完成后，先清理编译缓存再重新执行编译命令：

  lime clean [你的目标平台，比如windows/macos/linux/android]
  lime build [你的目标平台]
  

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