安装与 Lua 版本
UPM 引入 ZLua,用 Settings 选定 Lua 版本并完成本地 Install。
初始化与最小互调
Initialize、最简 C#→Lua 与 Lua→C#,跑通第一条互操作路径。
构建流程
Il2Cpp Player 的 Generate、Lua Sync 与发布检查清单。
EmmyLua 调试器
Editor Mono 下用 EmmyLua 对运行中的 Lua 断点调试(常用配置)。
Lua 调用 C#
访问类型、静态/实例成员、构造与 Event(add_/remove_)。
C# 调用 Lua
GetFunction、模块 return 约定、Editor/Player 加载路径。
值类型
enum、struct、Nullable 的默认跨边界形态与常见用法。
Function 与 Delegate
Lua function ↔ C# Delegate 的三条路径与注意事项。
数组
一维 / 多维数组的创建、索引、to_table 与 to_bytes。
泛型
闭合泛型类型与泛型方法在 Lua 侧的构造与调用。
ref / in / out
byref 参数的默认 Opaque 行为与写回规则。
LuaMarshalAs
覆盖默认 Marshal;Bytes / Opaque / UnpackedValues / Table / UserData 与 XML。
GC Marshal
OpaqueValue、UnpackedValues、string UserData 等少分配 Marshal 套路。
方法重载
默认分派、全签名键、LuaAlias 与 register_method 短名。
LuaAlias
[LuaAlias] 换名与 XML(luaAliasXmlPaths / ZLuaAlias)。
Extension 方法
[LuaExtension] 与 XML 将 C# extension 挂到被扩展类型的实例方法表。
常用 zlua 库
日常最常用的 zlua API;其余见规范。
第三方原生插件
socket / cjson 等第三方 Lua C 模块的 Editor(cpath)与 Player(静态 RequireF)双轨集成。
迁移指南
4 个项目
排错指南
ZLua 常见问题诊断与解决方案(附录)。
Editor 与 Player
Mono Editor 与 Il2Cpp Player 双运行时的差异(附录)。