1. 项目概述为什么要在C#里嵌入Lua如果你是一个C#开发者尤其是在做游戏客户端、工具软件、或者需要动态配置逻辑的应用时你肯定遇到过这样的困境每次修改一个规则、调整一个数值、或者增加一个简单的行为都需要重新编译、打包、发布整个项目。这个过程不仅耗时对于需要快速迭代或者交付给非技术同事比如策划、运营配置的场景来说简直是噩梦。这时候脚本语言就派上用场了。而Lua以其轻量、高效、易嵌入的特性成为了游戏行业和许多工具软件中的“标配”。在C#的世界里想要集成Lua我们有几个选择原生的Lua接口通过P/Invoke调用C库、NLua、KeraLua以及我们今天要深入探讨的——MoonSharp。MoonSharp是一个完全用C#编写的Lua解释器。这意味着你不需要额外部署任何原生的Lua DLL它纯托管与.NET环境无缝集成对Unity的支持也相当友好。它不仅仅是“能跑Lua”更提供了一套丰富的API让你能在C#和Lua之间优雅地传递数据、调用函数、甚至自定义类型。这个项目标题“C#使用MoonSharp实现Lua脚本嵌入完整示例代码”直指的核心就是如何从零开始在C#项目中搭建起与Lua脚本双向通信的完整桥梁。这不仅仅是执行一行print(“Hello”)而是涉及到脚本加载、变量交换、函数互调、错误处理等一整套生产级可用的实践。2. 环境准备与MoonSharp初探在开始写代码之前我们得先把“舞台”搭好。MoonSharp的引入非常简单对于现代C#项目来说最方便的方式莫过于通过NuGet包管理器。2.1 创建项目与安装MoonSharp首先打开你的Visual Studio或者你喜欢的IDE比如Rider创建一个新的控制台应用项目.NET Core、.NET 5/6/7/8或.NET Framework 4.6.1均可MoonSharp支持很广。项目创建好后右键点击项目依赖项选择“管理NuGet程序包”。在浏览选项卡中搜索“MoonSharp”你应该能很快找到它。点击安装等待片刻相关的依赖就会自动添加到你的项目中。这是最省心的方法避免了手动管理DLL的麻烦。安装完成后你可以在代码文件的开头添加using MoonSharp.Interpreter;来引入命名空间。至此你的C#项目就已经具备了执行Lua脚本的能力。这里有个小细节需要注意MoonSharp的版本。对于生产环境建议使用稳定的Release版本而不是预发布的Alpha或Beta版。你可以在NuGet包管理器的“版本”下拉框中查看和选择。2.2 理解MoonSharp的核心Script对象MoonSharp所有功能的起点都是一个Script类的实例。你可以把它理解为一个独立的Lua运行时环境。创建一个Script对象就相当于打开了一个全新的Lua虚拟机。using MoonSharp.Interpreter; class Program { static void Main(string[] args) { // 创建Lua脚本执行环境 Script script new Script(); } }这个script对象是你与Lua世界交互的总入口。它内部维护着Lua的全局表、函数、以及与你注册的C#对象的关联。一个常见的误区是试图用一个Script对象处理所有事情。实际上根据场景你可能需要创建多个独立的Script实例。比如不同的游戏关卡、不同的用户会话或者为了安全隔离不同的脚本逻辑时使用独立的Script实例可以避免全局状态的意外污染这是一个重要的设计考量。3. 基础交互从执行脚本到数据传递有了Script对象我们就可以开始尝试最基本的操作了。MoonSharp提供了几种执行Lua代码的方式适用于不同的场景。3.1 执行Lua代码的三种方式3.1.1 使用DoString执行内联脚本DoString方法是最直接的方式它接受一个字符串将其作为Lua代码执行。这非常适合执行简单的、动态生成的代码片段。Script script new Script(); DynValue result script.DoString( local a 10 local b 20 return a b, 计算完成 ); Console.WriteLine($结果1: {result.Tuple[0].Number}); // 输出结果1: 30 Console.WriteLine($结果2: {result.Tuple[1].String}); // 输出结果2: 计算完成注意DoString的返回值是一个DynValue对象。DynValue是MoonSharp中用来统一表示Lua所有数据类型nil, boolean, number, string, table, function, userdata等的包装类。当Lua代码返回多个值时如上例中的ab和字符串它们会被包装成一个“元组”Tuple你可以通过Tuple数组属性来访问各个返回值。3.1.2 使用DoFile加载并执行脚本文件当脚本逻辑变复杂时将代码写在单独的.lua文件中是更好的选择。首先在你的项目目录下比如和exe同级或者指定一个Scripts文件夹创建一个test.lua文件。重要对于控制台应用你需要确保这个.lua文件会被复制到输出目录。右键点击.lua文件属性“复制到输出目录”选择“如果较新则复制”或“始终复制”。-- test.lua function greet(name) return “Hello, ” .. name .. “!” end local score 100 print(“脚本加载完毕初始分数:”, score)然后在C#中加载并执行它try { DynValue result script.DoFile(“test.lua”); // DoFile通常会返回脚本块最后一条语句的值如果最后是函数定义或赋值可能返回nil } catch (SyntaxErrorException e) { Console.WriteLine($“Lua语法错误: {e.Message}”); } catch (ScriptRuntimeException e) { Console.WriteLine($“Lua运行时错误: {e.DecoratedMessage}”); // DecoratedMessage包含调用栈更友好 }使用DoFile的好处是代码管理清晰并且Lua编辑器可以提供语法高亮和错误提示。注意我添加了异常处理这是生产代码中必不可少的。MoonSharp会抛出特定的异常如SyntaxErrorException,ScriptRuntimeException来帮助你定位脚本中的问题。3.1.3 使用LoadString和LoadFile进行预编译如果你有一段脚本需要反复执行多次每次都进行解析DoString/DoFile会造成不必要的开销。这时可以使用LoadString或LoadFile方法它们将脚本代码编译成一个DynValue其类型为DataType.Function然后你可以反复调用这个编译好的函数。string luaCode “return arg1 * 2”; // 一个简单的乘法函数 DynValue compiledFunc script.LoadString(luaCode); for (int i 0; i 5; i) { DynValue callResult script.Call(compiledFunc, i); // 传入参数i Console.WriteLine($“{i} * 2 {callResult.Number}”); }LoadFile同理它从文件加载并编译。这种模式在脚本逻辑固定但参数变化频繁的场景下如计算公式、渲染小部件能显著提升性能。3.2 C#与Lua之间的数据交换脚本能执行了接下来就是让两个世界能“对话”。核心在于DynValue和Globals。3.2.1 从C#传递数据到Lua你可以通过Script.Globals这个属性来访问Lua的全局表。直接给它赋值就能在Lua中访问到。script.Globals[“playerName”] “阿珍”; script.Globals[“playerLevel”] 50; script.Globals[“isVIP”] true; script.DoString(“ print(‘玩家:’ .. playerName) -- 输出玩家:阿珍 if isVIP then print(‘是尊贵的VIP用户’) end ”);MoonSharp会自动处理基础类型数字、字符串、布尔的转换。对于复杂的C#对象需要额外的注册步骤我们后面会讲到。3.2.2 从Lua获取数据到C#执行完脚本后你可以从Globals中取出Lua全局变量的值或者通过Call方法的返回值获取。script.DoString(“ calculatedValue (playerLevel or 0) * 1.5 function GetBonus() return 1000 end ”); // 获取全局变量 DynValue luaCalculatedValue script.Globals.Get(“calculatedValue”); if (luaCalculatedValue.IsNotNil() luaCalculatedValue.Type DataType.Number) { double value luaCalculatedValue.Number; Console.WriteLine($“从Lua获取的计算值: {value}”); } // 调用Lua函数获取返回值 DynValue luaFunc script.Globals.Get(“GetBonus”); if (luaFunc.Type DataType.Function) { DynValue bonus script.Call(luaFunc); Console.WriteLine($“奖金: {bonus.Number}”); }这里的关键是类型检查。在访问DynValue的具体属性如.Number,.String前务必先用.IsNotNil()和.Type检查其是否有效以及数据类型否则可能导致运行时异常。4. 高级集成函数互调与对象绑定基础的数据传递只能算“打招呼”真正的威力在于让C#和Lua的函数能够相互调用并且让Lua能操作复杂的C#对象。4.1 将C#函数暴露给Lua这是最常见的需求让Lua脚本能够调用C#实现的复杂逻辑或访问引擎功能。4.1.1 使用委托Delegate注册全局函数最简单的方式是将一个C#委托如Action,Func赋值给Globals。// 无返回值一个字符串参数的函数 script.Globals[“LogMessage”] (Actionstring)((msg) { Console.WriteLine($“[LUA LOG] {DateTime.Now:HH:mm:ss}: {msg}”); }); // 有返回值两个数字参数的函数 script.Globals[“Add”] (Funcdouble, double, double)((a, b) a b); script.DoString(“ LogMessage(‘脚本开始运行’) local sum Add(5, 3.2) LogMessage(‘计算结果: ’ .. sum) -- 输出计算结果: 8.2 ”);4.1.2 使用MoonSharp的CallbackFunction特性对于更复杂的场景比如需要访问调用者信息、处理可变参数你可以定义一个方法并为其加上[MoonSharpUserDataMethod]特性如果是在自定义UserData类型中或者直接使用CallbackFunction。不过对于全局函数委托方式通常就足够了。4.2 将C#对象实例暴露给Lua让Lua能够直接操作一个C#对象比如一个“玩家”或“物品”实例需要用到MoonSharp的UserData机制。4.2.1 注册UserData类型首先你需要告诉MoonSharp哪种C#类型可以被暴露给Lua。这通过UserData.RegisterTypeT()实现。假设我们有一个简单的Player类public class Player { public string Name { get; set; } public int Health { get; set; } public int MaxHealth { get; set; } public void Heal(int amount) { Health Math.Min(Health amount, MaxHealth); Console.WriteLine($“{Name}恢复了{amount}点生命当前生命{Health}”); } public bool IsAlive() { return Health 0; } }在程序初始化时比如Main函数开头注册这个类型UserData.RegisterTypePlayer();4.2.2 将对象实例传入Lua注册类型后你就可以创建该类型的实例并将其赋值给Lua全局变量。Player myPlayer new Player { Name “勇者”, Health 70, MaxHealth 100 }; // 使用UserData.Create将C#对象包装成Lua可识别的形式 script.Globals[“hero”] myPlayer; script.DoString(“ print(‘英雄名称: ’ .. hero.Name) print(‘当前生命: ’ .. hero.Health) hero:Heal(30) -- 注意调用方法用冒号(:)会自动传递self if hero:IsAlive() then print(‘英雄还活着’) end ”);这里有一个关键细节在Lua中调用对象的方法有两种方式。hero.Heal(30)和hero:Heal(30)。前者是普通函数调用需要手动传递self参数即hero.Heal(hero, 30)这通常不符合我们的习惯。后者使用冒号是Lua的语法糖它会自动将hero作为第一个参数self传递给Heal方法。因此在C#中定义给Lua用的实例方法时第一个参数必须是该类的类型即this虽然我们在C#调用时省略了但MoonSharp在背后处理了这一切。我们的Heal方法定义public void Heal(int amount)是正确的因为MoonSharp能识别实例方法。4.2.3 控制暴露的成员默认情况下注册类型后它的所有公共属性、字段和方法都会暴露给Lua。有时我们需要更精细的控制。这时可以使用MoonSharpUserData特性和MoonSharpHidden特性。[MoonSharpUserData] // 明确标记这个类要暴露给Lua public class Item { public string Id { get; set; } // 会暴露 [MoonSharpHidden] // 这个字段对Lua隐藏 internal string InternalConfigKey; public string GetDescription() { return “一件物品”; } // 会暴露 [MoonSharpHidden] // 这个方法对Lua隐藏 private void SecretMethod() { } }使用[MoonSharpUserData]特性后甚至可以不用手动调用UserData.RegisterTypeItem()MoonSharp会在第一次遇到该类型时自动注册但显式注册在程序启动时完成是个好习惯。4.3 从Lua定义函数给C#调用反过来你也可以让Lua定义一些逻辑比如技能效果、AI行为然后由C#在合适的时机触发。这通常通过C#调用一个已知名称的Lua全局函数来实现。// 假设Lua脚本定义了游戏事件处理函数 script.DoFile(“GameEvents.lua”); // 在C#中当“玩家升级”事件发生时 void OnPlayerLevelUp(int newLevel) { DynValue luaHandler script.Globals.Get(“OnPlayerLevelUp”); if (luaHandler.Type DataType.Function) { try { // 调用Lua函数并传递参数 DynValue result script.Call(luaHandler, newLevel); // 可以处理Lua函数的返回值 if (result.IsNotNil()) { Console.WriteLine($“Lua脚本处理了升级事件返回: {result}”); } } catch (ScriptRuntimeException e) { Console.WriteLine($“调用Lua事件处理函数失败: {e.DecoratedMessage}”); } } else { // Lua脚本没有定义这个事件处理器静默忽略或使用默认逻辑 } }这种模式极大地提升了灵活性。游戏策划或设计师可以在不修改C#代码、不重启程序的情况下通过修改GameEvents.lua文件来调整升级后的奖励公式、触发特效等。5. 错误处理、调试与性能考量任何与外部脚本的集成健壮性都是重中之重。脚本中的一个小错误不应该导致整个宿主程序崩溃。5.1 异常捕获与友好错误信息如前所述MoonSharp的执行方法DoString,DoFile,Call可能会抛出异常。我们必须捕获它们。SyntaxErrorException: 脚本语法错误。e.Message包含了错误信息。ScriptRuntimeException: 脚本运行时错误如对nil值进行操作、调用不存在的函数。强烈建议使用e.DecoratedMessage它包含了Lua风格的调用栈信息能帮你快速定位错误发生在脚本的哪一行。InternalErrorException: MoonSharp解释器内部错误较少见。一个良好的错误处理封装示例public DynValue SafeDoFile(Script script, string filePath) { try { return script.DoFile(filePath); } catch (SyntaxErrorException synEx) { Console.WriteLine($“[语法错误] 文件{filePath}: {synEx.Message}”); // 可以在这里记录日志或者通知脚本编辑者 } catch (ScriptRuntimeException runtimeEx) { Console.WriteLine($“[运行时错误] 文件{filePath}: {runtimeEx.DecoratedMessage}”); } catch (Exception ex) // 捕获其他意外异常 { Console.WriteLine($“[系统错误] 执行脚本{filePath}时发生未知异常: {ex.Message}”); } return DynValue.Nil; // 返回一个Nil表示执行失败 }5.2 调试支持MoonSharp提供了一定的调试支持。你可以通过Script.Options.DebugPrint属性重定向Lua的print函数输出方便调试。script.Options.DebugPrint (s) { System.Diagnostics.Debug.WriteLine($“[LUA PRINT] {s}”); // 或者输出到你自己游戏的日志系统 };对于更复杂的调试如单步执行、查看变量MoonSharp的调试功能相对有限。在Unity中可以结合Unity的Console窗口和自定义日志。在纯C#环境中一个实用的“土办法”是在Lua脚本中大量使用print输出关键变量状态并将输出重定向到一个你可以查看的日志文件中。5.3 性能优化要点虽然Lua很快MoonSharp作为纯C#实现性能也不错但在高频调用或复杂逻辑下仍需注意避免频繁创建Script对象创建Script实例有一定开销。对于长期存在的脚本环境应复用同一个实例。预编译热点脚本对于需要每秒执行成千上万次的脚本逻辑如AI决策树叶子节点、伤害计算公式务必使用LoadString/LoadFile进行预编译然后反复Call编译好的函数对象。减少C#/Lua边界穿梭每次从C#调用Lua函数或从Lua回调C#函数都有一定的跨边界调用开销。如果一段逻辑需要密集的数据交换考虑将其完全放在一边要么全用C#写要么全用Lua写。例如不要在一个循环内每次迭代都去Lua里查一个配置值而应该一次性将所有配置值读到C#的缓存中。谨慎使用UserData操作UserData对象比操作基本类型number, string开销大。对于性能关键的路径考虑将所需数据以基本类型的形式传递给Lua。使用MoonSharp.Interpreter.Coroutine对于需要实现协程、延时逻辑的脚本比如一个复杂的剧情对话序列可以使用MoonSharp的协程支持这比用C#去模拟一个状态机来驱动Lua脚本更高效、更清晰。6. 完整示例一个简单的配置式奖励系统让我们把所有知识点串联起来实现一个迷你但完整的使用场景一个游戏奖励系统。奖励规则如登录奖励、任务奖励由Lua脚本配置C#负责触发奖励事件并执行脚本逻辑。第一步定义C#数据模型和接口// RewardItem.cs - 奖励物品 public class RewardItem { public string ItemId { get; set; } public int Count { get; set; } } // IPlayerService.cs - 玩家服务接口抽象便于测试 public interface IPlayerService { void AddItem(string itemId, int count); void AddGold(int amount); void SendMessage(string msg); }第二步实现具体的玩家服务简化版// GamePlayerService.cs public class GamePlayerService : IPlayerService { public void AddItem(string itemId, int count) { Console.WriteLine($“[系统] 获得物品 {itemId} x{count}”); // 实际项目中这里会更新玩家背包数据 } public void AddGold(int amount) { Console.WriteLine($“[系统] 获得金币 {amount}”); // 实际项目中这里会更新玩家金币数量 } public void SendMessage(string msg) { Console.WriteLine($“[消息] {msg}”); } }第三步编写Lua奖励脚本创建一个RewardLogic.lua文件-- RewardLogic.lua -- 奖励逻辑配置表 local RewardConfig { [“DailyLogin”] function(playerService, day) -- 每日登录奖励 if day 1 then playerService:AddGold(100) playerService:SendMessage(“欢迎回来首日登录奖励100金币。”) elseif day 7 then playerService:AddGold(500) playerService:AddItem(“PremiumChest”, 1) playerService:SendMessage(“连续登录一周获得豪华宝箱”) else playerService:AddGold(50) playerService:SendMessage(string.format(“第%d天登录获得50金币。”, day)) end end, [“QuestComplete”] function(playerService, questId, difficulty) -- 任务完成奖励 local baseReward { gold 200, item “ExpPotion” } if difficulty “Hard” then baseReward.gold baseReward.gold * 2 baseReward.item “SuperExpPotion” end playerService:AddGold(baseReward.gold) playerService:AddItem(baseReward.item, 1) playerService:SendMessage(string.format(“完成任务[%s](%s难度)”, questId, difficulty)) end } -- 全局函数供C#调用 function GrantReward(rewardType, playerService, ...) local handler RewardConfig[rewardType] if handler then handler(playerService, ...) return true else print(string.format(“警告未知的奖励类型 ‘%s’”, rewardType)) return false end end第四步C#端集成与调用// Program.cs using MoonSharp.Interpreter; class Program { private static Script luaScript; private static IPlayerService playerService; static void Main() { // 1. 初始化 playerService new GamePlayerService(); luaScript new Script(); // 2. 注册C#类型到Lua将接口实例传入 // 注意我们注册的是接口IPlayerService但传入的是实现类实例。 // MoonSharp会将其视为实现类的UserData。 UserData.RegisterTypeGamePlayerService(); // 注册具体类型 // 将实例以“Player”为名暴露给Lua脚本 luaScript.Globals[“Player”] playerService; // 注意这里名字和Lua脚本内的参数名无关 // 3. 加载奖励逻辑脚本 try { luaScript.DoFile(“RewardLogic.lua”); Console.WriteLine(“奖励逻辑脚本加载成功。”); } catch (Exception e) { Console.WriteLine($“加载奖励脚本失败: {e.Message}”); return; } // 4. 模拟触发奖励事件 Console.WriteLine(“\n 模拟每日登录 ); TriggerReward(“DailyLogin”, 1); // 第1天登录 TriggerReward(“DailyLogin”, 7); // 第7天登录 TriggerReward(“DailyLogin”, 3); // 第3天登录 Console.WriteLine(“\n 模拟任务完成 ); TriggerReward(“QuestComplete”, “SlayTheDragon”, “Normal”); TriggerReward(“QuestComplete”, “RescueThePrincess”, “Hard”); // 5. 尝试触发一个不存在的奖励类型 Console.WriteLine(“\n 测试错误处理 ); TriggerReward(“InvalidType”, “someData”); } static void TriggerReward(string rewardType, params object[] args) { // 获取Lua中的全局函数 DynValue grantFunc luaScript.Globals.Get(“GrantReward”); if (grantFunc.Type ! DataType.Function) { Console.WriteLine($“错误Lua脚本中未找到‘GrantReward’函数。”); return; } // 构建调用参数列表rewardType, playerService, 以及其他args object[] callArgs new object[args.Length 1]; callArgs[0] rewardType; callArgs[1] playerService; // 将玩家服务实例作为第二个参数传入 Array.Copy(args, 0, callArgs, 2, args.Length); try { DynValue result luaScript.Call(grantFunc, callArgs); if (result.IsNotNil() result.Type DataType.Boolean result.Boolean false) { Console.WriteLine($“奖励类型‘{rewardType}’处理失败Lua脚本返回false。”); } } catch (ScriptRuntimeException e) { Console.WriteLine($“执行奖励‘{rewardType}’时发生Lua运行时错误: {e.DecoratedMessage}”); } } }运行这个示例你会看到输出奖励逻辑脚本加载成功。 模拟每日登录 [系统] 获得金币 100 [消息] 欢迎回来首日登录奖励100金币。 [系统] 获得金币 500 [系统] 获得物品 PremiumChest x1 [消息] 连续登录一周获得豪华宝箱 [系统] 获得金币 50 [消息] 第3天登录获得50金币。 模拟任务完成 [系统] 获得金币 200 [系统] 获得物品 ExpPotion x1 [消息] 完成任务[SlayTheDragon](Normal难度) [系统] 获得金币 400 [系统] 获得物品 SuperExpPotion x1 [消息] 完成任务[RescueThePrincess](Hard难度) 测试错误处理 警告未知的奖励类型 ‘InvalidType’ 奖励类型‘InvalidType’处理失败Lua脚本返回false。这个示例展示了完整的闭环C#提供基础设施玩家服务Lua定义具体业务规则奖励内容C#触发事件并传入上下文Lua脚本根据规则调用C#服务完成操作。所有奖励逻辑的修改都只需要编辑RewardLogic.lua文件无需重新编译C#项目。7. 常见问题与避坑指南在实际集成MoonSharp的过程中你肯定会遇到一些坑。下面是我总结的几个典型问题及其解决方案。7.1 Lua脚本中调用C#对象方法时报错“attempt to call method ‘XXX’ (a nil value)”原因1最可能的原因是在Lua中用了点号.而不是冒号:来调用方法。记住调用需要self的实例方法必须用冒号。原因2C#方法不是public的。MoonSharp默认只能访问公共成员。检查方法访问修饰符。原因3该类型未被正确注册为UserData。确保在访问对象实例前已经执行了UserData.RegisterTypeYourType()。原因4你注册的是基类或接口但方法在派生类中。MoonSharp需要知道对象的具体类型。确保你注册了实际传入的对象类型。7.2 性能瓶颈发现脚本调用处CPU占用很高排查点1是否在循环或每帧更新中频繁调用DoString或DoFile改为LoadString/LoadFile预编译然后调用编译好的函数。排查点2是否在Lua和C#边界频繁传递大量数据或复杂对象考虑将数据序列化为Lua原生的table使用DynValue.NewTable和Script的Table相关API构建再传递或者合并调用减少往返次数。排查点3Lua脚本本身逻辑是否过于复杂虽然Lua快但复杂的数值计算或字符串处理仍可能成为瓶颈。对于极度性能敏感的部分考虑用C#实现通过回调暴露给Lua。7.3 内存泄漏Script对象或DynValue未释放原则Script对象持有Lua运行时状态。如果你创建了大量短期Script对象务必在不用时将其置为null以便GC回收。长期存在的Script对象则不用担心。注意从Lua传回C#的DynValue特别是包含UserData或Closure的可能会持有对C#对象的引用阻止其被GC。如果只是临时使用无需特别处理。如果是长期缓存注意管理其生命周期。7.4 如何让Lua脚本能“require”其他Lua模块MoonSharp默认的脚本加载器只能加载你通过DoFile指定的单个文件。要支持Lua标准的require函数你需要自定义一个IScriptLoader。public class MyScriptLoader : ScriptLoaderBase { // 定义你的脚本文件根目录 private string _scriptRootPath; public MyScriptLoader(string scriptRootPath) { _scriptRootPath scriptRootPath; } // 当一个脚本require “moduleX”时会调用此方法获取文件内容 public override object LoadFile(string file, Table globalContext) { string path Path.Combine(_scriptRootPath, file.Replace(‘.’, ‘/’) “.lua”); if (File.Exists(path)) { return File.ReadAllText(path); } // 如果找不到可以尝试加.lua后缀或者抛出错误 throw new FileNotFoundException($“Lua模块文件未找到: {path}”); } // 必须重写用于标识加载器的唯一性 public override string ResolveFileName(string filename, Table globalContext) { return filename; } } // 使用方式 Script script new Script(); script.Options.ScriptLoader new MyScriptLoader(“./Scripts”); // 现在在Lua脚本中就可以使用 require “MyModule” 了7.5 在Unity中使用MoonSharp的特殊注意事项IL2CPP与代码裁剪如果你的Unity项目发布时使用IL2CPP后端并启用了代码裁剪Code Stripping那些仅通过反射MoonSharp的UserData注册依赖反射调用的方法可能会被错误地裁剪掉。解决方案是在Assets/link.xml文件中添加保留规则或者使用[Preserve]特性标记相关类型和方法。Unity对象生命周期将UnityEngine.Object派生类如GameObject,MonoBehaviour的实例传入Lua时要格外小心。如果C#端的对象被Destroy了而Lua还持有其引用后续访问会导致错误。一种模式是使用弱引用包装或者在C#对象销毁时主动清理Lua中的对应引用。最后集成脚本引擎是一个权衡的艺术。MoonSharp为你提供了强大的能力但也要意识到其复杂性。从简单的配置脚本开始逐步扩展到复杂的行为逻辑并始终做好错误隔离和性能监控这样你就能构建出既灵活又健壮的C#应用程序。
