跳到主要内容

ZLua DocsAlpha

原生 Lua · 完备 C# 互操作 · 针对 Unity Il2Cpp 优化

Mono · 已完成Il2Cpp · 已完成

Unity LTS · 团结引擎 · 多种 Lua 引擎,查看兼容性

⚡

更易用 · 零配置

声明式 GetFunction / [LuaMarshalAs],CSharp 懒加载;无需 per-type C# Wrap 白名单,屏蔽底层 Lua C API。

🚀

原生 C++ 互调

Il2Cpp 使用原生 C++ 桥;实测结果、测试环境与适用边界见性能报告。

📦

更小桥接 · 更少 GC

C++ stub 按签名复用,减少重复桥接代码;低分配效果取决于数据类型、调用方向和预热状态。

双向调用一览

C# · GetFunction

// Bootstrap.cs
[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
private static void InitZLuaOnStartup()
{
    LuaAppDomain.Initialize(LoadLuaModule);
}

Action AppMain;
Func<int, int, int> AppAdd;

void Awake()
{
    AppMain = LuaAppDomain.GetFunction<Action>("app", "main");
    AppAdd = LuaAppDomain.GetFunction<Func<int, int, int>>("app", "add");
}

Lua · app.lua

-- app.lua
local function main()
    print("lua main start")
end

local function add(a, b)
    return a + b
end

return {
    main = main,
    add = add,
}