MacOS Catalina环境下如何交叉编译Lua脚本为32位兼容字节码？

问题根因 #

Lua预编译字节码的加载校验逻辑是硬编码在虚拟机里的：加载器会逐字节比对文件头的元信息，包括当前编译环境的字长、各数据类型的占比大小、版本号等字段，只要有一个字段和运行端的虚拟机配置不匹配，就会直接抛出bad header in precompiled chunk错误。
很多人误以为需要跑32位的编译环境才能出32位兼容的字节码，实际上只要编译端luac输出的头元信息和运行端的32位Lua配置对齐，哪怕luac本身是64位程序，输出的字节码也可以被正常加载，完全不需要依赖Docker这类虚拟化方案。

实现路径（按简洁度从高到低排序） #

方案1：直接修改现有字节码的头部字段（零编译成本） #

如果你的业务脚本不存在超长字符串、超大数组这类需要超过4字节寻址的内容，可以直接在你当前已经生成的64位字节码文件基础上改1个字节：

• 用任意十六进制编辑器打开现有my-binary.luac文件
• 跳过前12字节的固定文件签名块，找到第13个字节——这个位置记录的是编译端size_t的长度：64位系统下默认值是8，32位标准Lua的这个值是4，直接把对应字节的值从0x08改成0x04
• 保存文件后直接测试加载即可

注意：如果脚本内包含长度超过2^32-1的字符串、表项，改头后会因为长度解析错误崩溃，正常业务场景下基本不会触发这类问题。

方案2：本地编译自定义配置的luac工具（可靠性最高） #

如果不想手动改二进制，或者需要适配非标准配置的32位Lua环境，本地编译一个轻量的luac工具即可，完全不需要跨架构编译、不需要跑32位子系统：

1. 先确认目标32位Lua的核心编译参数：包括对应Lua的大版本（5.1/5.2/5.3/5.4）、各数据类型的字节长度（int、size_t、虚拟机指令字长、lua_Number的类型和长度）
2. 获取对应版本的Lua源码包，修改luaconf.h中的配置宏，把所有和目标32位Lua一致的参数逐一对齐（比如标准32位Lua 5.1只需要开启LUA_32BITS宏，把size_t的长度配置为4字节即可）
3. 在当前Catalina的64位环境下直接执行make luac，编译产出的luac工具整体体积不到500KB，直接沿用你原来的编译命令luac -s -o bin/my-binary.luac src/my-code.lua即可输出完全兼容的32位字节码

对比Docker方案：整个过程不需要拉取镜像、启动容器，仅需本地编译一次luac，后续所有编译操作都和原来的流程完全一致，耗时仅为Docker方案的1/10不到。

常见踩坑提醒 #

• 不要直接用系统自带的/usr/bin/luac工具，这个工具的配置是和系统预装的64位Lua绑定的，无法自定义参数
• 必须严格对齐目标端的Lua版本：如果目标端运行的是LuaJIT而非标准Lua，普通的luac无法输出LuaJIT兼容的字节码，需要获取对应版本的LuaJIT源码编译专属的luac工具
• 你原命令中的-s剥离调试信息参数是字节码层的通用选项，和字长无关，在32位端完全兼容，不需要调整命令参数

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