当前位置：首页 > news >正文

Lua调用C#技术文档

news 2026/5/11 20:30:48

1 Lua调用C#类

C#代码

using UnityEngine;public class Lesson1
{public static void Eat(){Debug.Log("Eat");}public void Speak(string str){Debug.Log(str);}
}

Lua代码

Lesson1 = CS.Lesson1--调用静态方法
Lesson1.Eat()--实例化对象
local obj = Lesson1()--调用成员方法
obj:Speak("Hello Lua")

知识补充

Lua 调用 C# 类的规则：

CS.命名空间.类名

注意：

静态方法：. 调用
成员方法：: 调用
Lua 没有 new，实例化直接 ClassName()

2 Lua调用C#枚举

C#代码

public enum E_MyEnum
{Idle = 0,Move = 1,Atk = 2
}

Lua代码

PrimitiveType = CS.UnityEngine.PrimitiveType
GameObject = CS.UnityEngine.GameObjectlocal obj = GameObject.CreatePrimitive(PrimitiveType.Cube)E_MyEnum = CS.E_MyEnumlocal a = E_MyEnum.Idle
print(a)local b = E_MyEnum.__CastFrom(1)
print(b)local c = E_MyEnum.__CastFrom("Atk")
print(c)

知识补充

枚举调用规则：

CS.命名空间.枚举.成员

枚举转换：

__CastFrom(数字)
__CastFrom(字符串)

3 Lua调用C#数组、List、Dictionary

C#代码

using System.Collections.Generic;public class Lesson3
{public int[] array = new int[] {1,2,3};public List<int> list = new List<int>();public Dictionary<int,string> dic = new Dictionary<int,string>();
}

Lua代码

local obj = CS.Lesson3()print(obj.array.Length)
print(obj.array[0])for i=0,obj.array.Length-1 doprint(obj.array[i])
endobj.list:Add(1)
obj.list:Add(2)print(obj.list.Count)for i=0,obj.list.Count-1 doprint(obj.list[i])
endobj.dic:Add(1,"123")for k,v in pairs(obj.dic) doprint(k,v)
end

知识补充

注意：

类型	长度
Array	Length
List	Count

Lua 索引从 1开始，但 C# 数组从 0开始。

4 Lua调用C#拓展方法

C#代码

using UnityEngine;
using XLua;[LuaCallCSharp]
public static class Lesson4Extension
{public static void Move(this Lesson4 obj){Debug.Log("Move Extension");}
}public class Lesson4
{public static void Eat(){Debug.Log("Eat");}public void Speak(string str){Debug.Log(str);}
}

Lua代码

Lesson4 = CS.Lesson4Lesson4.Eat()local obj = Lesson4()obj:Speak("Hello")obj:Move()

知识补充

拓展方法必须：

[LuaCallCSharp]

Lua 调用方式：

obj:ExtensionMethod()

5 Lua调用C# ref / out

C#代码

public class Lesson5
{public int RefFun(int a, ref int b, ref int c){b = 10;c = 20;return a;}public int OutFun(int a, out int b){b = 50;return a;}
}

Lua代码

local obj = CS.Lesson5()local a,b,c = obj:RefFun(1,0,0)
print(a,b,c)local a,b = obj:OutFun(20)
print(a,b)

知识补充

返回规则：

第一个返回值：函数返回值
后面：ref/out参数

区别：

参数	是否需要占位
ref	需要
out	不需要

6 Lua调用C#函数重载

C#代码

public class Lesson6
{public int Calc(int a){return a;}public float Calc(float a){return a;}
}

Lua代码

local obj = CS.Lesson6()print(obj:Calc(10))
print(obj:Calc(10.2))

知识补充

Lua 只有一种数值类型：

Number

因此可能无法区分：

int
float
double

解决方法：

xlua.tofunction()

使用反射指定函数。

7 Lua调用C#委托和事件

C#代码

using System;public class Lesson7
{public Action del;public event Action eventAction;public void DoEvent(){eventAction?.Invoke();}public void ClearEvent(){eventAction = null;}
}

Lua代码

local obj = CS.Lesson7()local fun = function()print("Lua委托")
endobj.del = fun
obj.del = obj.del + funobj.del()obj.del = obj.del - funlocal fun2 = function()print("事件")
endobj:eventAction("+",fun2)obj:DoEvent()obj:eventAction("-",fun2)obj:ClearEvent()

知识补充

区别：

类型	操作
委托	`=` `+` `-`
事件	`event("+",func)`

8 Lua调用C#二维数组

C#代码

public class Lesson8
{public int[,] array ={{1,2,3},{4,5,6}};
}

Lua代码

local obj = CS.Lesson8()print(obj.array:GetLength(0))
print(obj.array:GetLength(1))print(obj.array:GetValue(0,0))for i=0,obj.array:GetLength(0)-1 dofor j=0,obj.array:GetLength(1)-1 doprint(obj.array:GetValue(i,j))end
end

知识补充

二维数组访问：

GetValue(i,j)

不能使用：

array[i][j]
array[i,j]

9 Lua判断C# null

C#代码

public class Lesson9
{
}

Lua代码

GameObject = CS.UnityEngine.GameObject
Rigidbody = CS.UnityEngine.Rigidbodylocal obj = GameObject("Test")local rig = obj:GetComponent(typeof(Rigidbody))if rig:IsNull() thenrig = obj:AddComponent(typeof(Rigidbody))
end

知识补充

Lua 的

nil

不等于 C# 的

null

推荐判断方式：

obj:IsNull()

10 Lua调用Unity UI事件

C#代码

无需额外脚本，使用 Unity UI。

需要在配置中：

[CSharpCallLua]
public static List<Type> CSharpCallLua = new List<Type>()
{typeof(UnityEngine.Events.UnityAction<float>)
};

Lua代码

GameObject = CS.UnityEngine.GameObject
UI = CS.UnityEngine.UIlocal slider = GameObject.Find("Slider")local sliderScript = slider:GetComponent(typeof(UI.Slider))sliderScript.onValueChanged:AddListener(function(f)print(f)
end)

知识补充

UI 事件本质：

UnityEvent

Lua 注册回调：

AddListener(luaFunc)

11 Lua调用C#协程

C#代码

using UnityEngine;public class CoroutineRunner : MonoBehaviour
{
}

Lua代码

util = require("xlua.util")GameObject = CS.UnityEngine.GameObject
WaitForSeconds = CS.UnityEngine.WaitForSecondslocal obj = GameObject("Coroutine")local mono = obj:AddComponent(typeof(CS.CoroutineRunner))fun = function()local a = 1while true docoroutine.yield(WaitForSeconds(1))print(a)a = a + 1if a > 10 thenmono:StopCoroutine(co)endend
endco = mono:StartCoroutine(util.cs_generator(fun))

知识补充

Lua 协程必须转换：

util.cs_generator(luaFunc)

Lua 使用：

coroutine.yield()

代替：

yield return

12 Lua调用C#泛型函数

C#代码

public class Lesson12
{public void TestFun1<T>(T a,T b){}public void TestFun2<T>(T a){}
}

Lua代码

local obj = CS.Lesson12()local testFun2 = xlua.get_generic_method(CS.Lesson12,"TestFun2")local testFun2_R = testFun2(CS.System.Int32)testFun2_R(obj,1)