跳到主要内容

Extension 方法

把 C# extension methods 挂到被扩展类型的 Lua 实例 methodTable，支持 obj:ExtFoo(...)。权威：13-EXTENSION-METHODS。

不做全局扫描 ExtensionAttribute。配置模型是：被扩展类型 → 扩展类列表；Bind 该类型时再反射这些扩展类。

配置​

方式用法
能改被扩展类型源码[LuaExtension(typeof(FooExt), …)] 标在被扩展类型上
第三方 / 预编译类型Settings luaExtensionXmlPaths + 根元素 ZLuaExtensions

[LuaExtension] 不要标在扩展类上（否则为发现扩展必须扫全程序集）。

using ZLua;

public static class TransformExt
{
    public static void ResetLocal(this UnityEngine.Transform t)
    {
        t.localPosition = UnityEngine.Vector3.zero;
    }
}

[LuaExtension(typeof(TransformExt))]
public class PlayerView : MonoBehaviour { }
<?xml version="1.0" encoding="utf-8"?>
<ZLuaExtensions version="1">
  <Assembly name="UnityEngine.CoreModule">
    <Type fullName="UnityEngine.Transform">
      <Extension assembly="Assembly-CSharp" fullName="MyGame.TransformExt"/>
    </Type>
  </Assembly>
</ZLuaExtensions>

同一被扩展类型上：Attribute 与 XML 的扩展类列表取 并集。Bind T 时还会收集 基类上的 [LuaExtension]。

Il2Cpp：XML 在 Generate 期写入静态表，Player 不读 XML（改完须重新 Generate）。

Lua 用法​

local t = go.transform
t:ResetLocal()   -- 冒号；底层是静态扩展方法

筛选规则：扩展类上带 ExtensionAttribute 的 public static 方法，且第一个参数能接住该被扩展类型（含 this Base 用于 Derived）。开放泛型扩展 不支持。

与实例方法同名​

扩展与真实例 合并竞争（同一 overload 组），无「实例优先」。消歧用全签名键或 [LuaAlias]。见 方法重载。

常见错误​

现象原因
obj:Foo 为 nil未在被扩展类型（或基类）配置扩展类；或 Il2Cpp 未重新 Generate
只能 Ext.Foo(obj)未走 static-as-instance / 未进 IMT（实现须符合规范 §4）
调到错误重载合并竞争；用全签名键或 Alias 消歧
标在扩展类上的 Attribute 无效发现只扫被扩展类型上的 [LuaExtension]

学习路径​

上一篇LuaAlias
下一篇常用 zlua 库

相关文档​