介绍
ZLua 是一个针对 Unity Il2Cpp 极致优化的现代原生 Lua 方案。
它用清晰的规则统一 C# 与 Lua 的双向调用,把 Lua 当作另一种 Native——类比 P/Invoke,提供 LuaAppDomain.GetFunction、[LuaMarshalAs] 等概念,屏蔽底层易错的 Lua C API。
为什么选择 ZLua
相对 xLua / toLua / SLua,ZLua 的核心主张是:
| 更易用 | 现代、简单、零配置(无 per-type C# Wrap 白名单) |
| 更完备 | 几乎覆盖全部常用 C#↔Lua 特性(泛型、重载、ref/out、数组、delegate…) |
| 更高效 | 已公开四方 Il2Cpp 实测;报告、环境与统计数据统一见 性能对比。 |
| 更少 GC | 提供低分配 Marshal 路径;须区分托管 / Lua 分配、首次绑定 / 稳态。见 GC 边界。 |
| 共享桥接 | C++ stub 按约简签名复用;包体收益需要实测,见 桥接分析。 |
| 版本更广 | 多种 Lua 引擎与维护中的 Unity LTS 系列;版本、平台与分支限制统一见 兼容性矩阵。 |
| HybridCLR 热更 | 统一安装与运行时元数据注册;步骤见 HybridCLR 集成。 |
| 维护更积极 | 全职专业团队 |
完整论述见 为什么选择 ZLua;四方对照见 选型对比。
核心特性
| 能力 | 说明 |
|---|---|
| Lua → C# | CSharp 根表懒加载;字段/方法/属性;泛型与数组;重载;add_/remove_ 订阅 event |
| C# → Lua | LuaAppDomain.GetFunction<T> 取得 Delegate 后 Invoke |
| 双运行时 | Mono(Editor)与 Il2Cpp(Player)均已完成;语义一致、实现路径不同 |
| Marshal | ByVal / ByObj / Opaque 等路径,见 Marshal 规范 |
:::info 当前状态 Mono · 已完成Il2Cpp · 已完成
日常在 Editor(Mono) 开发;发版与性能以 Il2Cpp Player 为准(构建前 ZLua/Generate/All)。详见 项目状态。
:::
下一步
- 快速开始 — 跑通最小示例
- 为什么选择 ZLua — 选型理由
- 安装与集成 — UPM 安装与工程结构
- 使用指南 — 循序渐进教程(安装 → 互调 → 构建 → …)
- HybridCLR 集成 — 双包安装顺序与热更约束
- 选型对比 — 相对 xLua / toLua / SLua
- 性能基准 — 可复现 Il2Cpp 对比与最新报告
- 规范总览 — 权威语义契约