为什么选择 ZLua
xLua、toLua、SLua 已经证明「在 Unity 里用 Lua」可行。ZLua 要解决的是下一层问题:把 Lua↔C# 做成真正现代、完备、且在 Il2Cpp 上足够快、足够省的互操作——而不是再堆一套配置、白名单和海量 Wrap。
七个理由(30 秒)
| 一句话 | |
|---|---|
| 更易用 | 设计更现代;极度简单;零配置(无需 per-type C# Wrap 白名单) |
| 更完备 | 标准、完备的 C#↔Lua 交互,几乎覆盖全部常用 C# 特性 |
| 更高效 | 已公开四方 Il2Cpp 实测;报告、环境与统计数据统一见 性能对比。 |
| 更少 GC | 提供低分配 Marshal 路径;须区分托管 / Lua 分配、首次绑定 / 稳态。见 GC 边界。 |
| 共享桥接 | C++ stub 按约简签名复用;包体收益需要实测,见 桥接分析。 |
| 版本更广 | 多种 Lua 引擎与维护中的 Unity LTS 系列;版本、平台与分支限制统一见 兼容性矩阵。 |
| 维护更积极 | 全职专业团队;Bug 响应与特性迭代更快 |
1. 更易用:现代、简单、零配置
传统方案的心智负担往往是:
- 维护
LuaCallCSharp/ 导出列表 - 改 API 就要重新 Generate 海量 C# Wrap
- C#→Lua 走命令式
LuaEnv/GetInPath/Call
ZLua 把互操作做成接近 P/Invoke 的声明式模型:
| 你要做的事 | ZLua |
|---|---|
| C# 调 Lua | LuaAppDomain.GetFunction<T>(…) 取得 Delegate 后 Invoke |
| 覆盖 Marshal | [LuaMarshalAs] |
| Lua 访问 C# | CSharp 根表懒加载,无需为每个类型写 Wrap 配置 |
// 须在 Initialize 之后(例如 Awake),勿用 static 字段初始化器
var AppAdd = LuaAppDomain.GetFunction<Func<int, int, int>>("app", "add");
// AppAdd(10, 20);
CSharp['AC'] = CSharp['Assembly-CSharp']
print(CSharp.AC.Demo.Add(3, 5))
零配置指:不需要 per-type C# Wrap 白名单与成员级 Wrap 工程。Editor 开箱即用;发 Il2Cpp Player 时执行一次 ZLua/Generate/All(生成 C++ stub,不是 xLua 式 C# Wrap)。
2. 更完备:几乎能调到的 C# 都能调
目标不是「导出几个热路径 API」,而是 标准和完备的 C#↔Lua 交互,包括但不限于:
| 类别 | 能力 |
|---|---|
| 类型 | class / struct / interface / enum / nullable |
| 成员 | 静态与实例:字段、属性、方法 |
| 高级 | 泛型类、泛型方法、delegate、数组(含多维) |
| 语言细节 | 方法重载、ref / out / in、Event(add_ / remove_) |
语义以 规范 为契约;双端(Mono Editor / Il2Cpp Player)Lua 可见行为一致。
3. 更高效:不是「理论上快一点」
在 Il2Cpp Win64 Release 上四方对齐基准(公开仓库 zlua-benchmark;说明见 PERFORMANCE):
报告、Unity 版本、用例数量、比值与测试边界统一见 性能对比。
根因很直接:去掉 libxlua 折返 + 海量 C# Wrap,在 C++ 里一次完成 marshal 与 methodPointer 调用。
互调再快,也要先 profiling。若脚本边界只占帧时间 2%,五倍互调也只省约 1.6%。ZLua 适合 战斗公式、UI、每帧大量小调用 这类边界热点。
→ 性能对比
4. 更少更快的 GC
默认策略面向热路径:
| 策略 | 含义 |
|---|---|
| 引用类型 | 默认走对象表 / userdata,避免无意义装箱与临时 object[] |
| struct | 表示方式与分配取决于字段、方向和 Marshal 策略,应在目标 Player 测量。 |
| OpaqueValue | lightuserdata 临时句柄:同步调用链内更灵活的低分配策略 |
| enum | 默认 integer,不强制 boxed userdata |
需要写回时用 Opaque / ByVal userdata;裸 number 不回写(与 C# ref 语义对齐,见 ref/out/in)。
5. 按签名复用的 C++ 桥接
| 方案 | 典型体积模型 |
|---|---|
| xLua / toLua / SLua | 每类型 / 每成员 生成 Wrap,体积近似随导出成员线性膨胀 |
| ZLua(Il2Cpp) | 合并同签名 桥接函数,直接生成高效 C++ stub(ReducedType 复用) |
因此在「仍能访问几乎全部 C# 类型、字段、属性、方法」的前提下:
- 签名复用减少重复桥接代码;二进制体积倍数尚未实测。
- 生成源码、独立 stub 数量与最终 Player 体积须分别统计,不能从模型直接推出固定倍数或性能结论。
Editor(Mono)用 Expression Emit,不进 Player 包;Player 体积由 C++ stub 决定。
→ 桥接与体积
6. 支持的 Unity 与 Lua 更多
多版本意味着更少「卡在某个 Lua/Unity 组合」的选型风险。完整矩阵见 兼容性。
→ 支持的版本与平台
7. 维护更积极
ZLua 由 全职专业团队 维护:
- Bug 响应更积极
- 特性与规范迭代更快
- 文档、基准与包内
Docs同源演进
适合把 Lua 互操作当作 长期基础设施,而不是「停更的第三方插件」。
不适合选 ZLua 的情况
诚实边界同样重要:
| 情况 | 建议 |
|---|---|
| 不愿维护 libil2cpp 集成 | 插件形态的 xLua / toLua 更轻 |
| 强依赖 xLua Hotfix 管线 | 继续使用 xLua |
| 已有大量 xLua 资产、短期无迁移预算 | 先读 从 xLua 迁移 |
下一步
延伸阅读
| 文档 | 内容 |
|---|---|
| 设计概览 | GetFunction 与双向桥接 |
| 双运行时 | Mono / Il2Cpp 分工 |
| 术语表 | Opaque / ByVal / stub 等 |
| Il2Cpp 实现 | Player 模块图 |