ZLua — 面向 Il2Cpp 的现代 Unity Lua 方案

ZLua 是一套现代、简洁、易用的 Unity Lua 脚本方案，针对 Il2Cpp Player 做极致优化：Editor Mono 与 Player Il2Cpp 的 Lua 可见语义一致，强调高性能、低 GC、极小桥接体积，并做到零 per-type C# Wrap 配置。

核心特点

• 更易用：现代 API；初始化只需 Module Loader；无需 LuaCallCSharp / 海量 C# Wrap
• 更完备：覆盖 class/struct/interface/enum/nullable、泛型、delegate、数组、重载、ref/out/in、Event 等常用 C# 能力
• 更高效：Il2Cpp 实测相对 xLua：约 98% 对齐用例更快；Lua→C# 平均约 2.62×；常见字段/属性/调用约 4×
• 更少 GC：引用类型与 struct（含含引用字段的 struct）默认追求 0 GC；提供 OpaqueValue 等策略
• 极小桥接：同签名 C++ stub 合并；字段/无参属性可不单独生成桥接；支持 0 桥接函数
• 版本更广：Lua 5.1–5.5；Unity 2021.3 / 2022.3 / 6000.0 / 6000.3；团结引擎全系列；Il2Cpp 支持的平台（含 WebGL、微信小游戏、鸿蒙/车机等）

风格定位

ZLua 的产品风格是：现代、克制、工程化。

• 少配置、少生成物噪音，把精力放在业务 Lua / C# 逻辑上
• Lua 访问 C# 语法贴近 C#（Type.Static() / obj:Method() / obj.field）
• 桥接落在 C++ stub，而不是再堆一层 C# Wrap
• 以可长期维护的互操作语义与版本矩阵为目标，而不是“临时能跑”

适合的项目类型

• 长线运营 / 热更新游戏（活动、任务、UI、数值与内容脚本）
• 手游、小游戏、包体与性能敏感项目（Il2Cpp 体积与调用路径）
• 中大型 Unity 工程（泛型、重载、struct、事件等完整互操作，避免 Wrap 维护成本）
• 需要 Editor 与真机语义一致的团队（Mono 开发 → Il2Cpp 发布）
• 多引擎/长生命周期产品（Unity LTS、Unity 6、团结；Lua 5.1 到 5.5）
• 已有 HybridCLR / 混合技术栈的团队，作为 Lua 业务层底座

不太适合：几乎不需要访问 C# 的极简沙箱，或强依赖旧框架 Wrap 目录习惯的迁移（需按 ZLua 模型调整）。