如何从LFS（Lua Flash Store）镜像中提取已编译的Lua代码（.lc文件）？

以下是经过验证的落地操作流程：

前置准备 #

• 确认你提取的LFS镜像对应的NodeMCU固件使用的Lua版本，常见为Lua 5.1或Lua 5.3，必须保证后续反编译用的luadec版本和该版本完全匹配，否则会解析失败
• 准备NodeMCU官方的LFS镜像解析工具lfsimg，该工具专门用于读写LFS镜像的内容

操作步骤 #

步骤1：编译lfsimg工具 #

• 拉取nodemcu-firmware源码，进入tools/lfsimg目录，按照目录内说明编译对应操作系统的可执行文件
• 编译完成后执行./lfsimg help，确认输出正常命令说明即工具可用

步骤2：批量导出.lc文件 #

• 执行提取命令：./lfsimg export <你的LFS镜像本地路径> <导出结果存放目录路径>
• 命令执行完成后，结果目录内会生成所有打包进LFS的.lc编译文件，文件名和你当初打包时的源文件名完全对应

步骤3：验证文件有效性 #

• 执行对应版本luac的检查命令：luac -l <导出的lc文件路径>，如果能正常输出字节码列表，说明文件提取无误，可直接送入luadec反编译

无lfsimg时的手动解析方案 #

如果无法编译官方工具，可以根据LFS固定结构手动提取：

• LFS镜像开头4字节为固定魔数LFS\0，后续依次为文件表区和数据存储区
• 遍历文件表区，每个表项包含文件名、文件大小、数据偏移地址三个核心字段
• 按照每个表项的偏移地址和文件大小，从镜像中截取对应字节，保存为.lc后缀文件即可
• 提取完成后可通过lc文件头魔数验证：Lua5.1编译的lc文件头为\x1bLua，匹配即说明截取正确

常见问题排查 #

• 如果lfsimg提示镜像格式不匹配，先确认你提取的LFS镜像是否完整无截断，同时确认lfsimg的版本和当初编译LFS的NodeMCU固件版本分支一致
• 如果导出的lc文件反编译结果乱码，优先核对luadec版本和编译LFS的Lua版本是否匹配，Lua的编译字节码不支持跨版本解析

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