[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-6272":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":16,"forks30d":16,"starsTrendScore":19,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":31,"readmeContent":32,"aiSummary":33,"trendingCount":16,"starSnapshotCount":16,"syncStatus":34,"lastSyncTime":35,"discoverSource":36},6272,"xLua","Tencent\u002FxLua","Tencent","xLua is a lua programming solution for  C# ( Unity, .Net, Mono) , it supports android, ios, windows, linux, osx, etc.","",null,"C",10096,2501,512,278,0,6,20,4,75,"Other",false,"master",true,[26,27,28,29,30],"csharp","lua","unity","unity3d","xlua","2026-06-12 04:00:27","![](Assets\u002FXLua\u002FDoc\u002FxLua.png)\r\n\r\n[![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue.svg)](https:\u002F\u002Fgithub.com\u002FTencent\u002FxLua\u002Fblob\u002Fmaster\u002FLICENSE.TXT)\r\n[![release](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Frelease-v2.1.15-blue.svg)](https:\u002F\u002Fgithub.com\u002FTencent\u002FxLua\u002Freleases)\r\n[![PRs Welcome](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-blue.svg)](https:\u002F\u002Fgithub.com\u002FTencent\u002FxLua\u002Fpulls)\r\n[![Build status](https:\u002F\u002Fgithub.com\u002FTencent\u002FxLua\u002Factions\u002Fworkflows\u002Fbuild.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FTencent\u002FxLua\u002Factions\u002Fworkflows\u002Fbuild.yml)\r\n\r\n[(English Documents Available)](README_EN.md)\r\n\r\n## C# 下 Lua 编程支持\r\n\r\nxLua 为 Unity、.Net、Mono 等 C# 环境增加 Lua 脚本编程的能力，借助 xLua，这些 Lua 代码可以方便的和 C# 相互调用。\r\n\r\n\u003Cbr\u002F>\r\n\r\n## xLua 的突破\r\n\r\nxLua 在功能、性能、易用性都有不少突破，这几方面分别最具代表性的是：\r\n\r\n* 可以运行时把 C# 实现（方法，操作符，属性，事件等等）替换成 Lua 实现；\r\n* 出色的 GC 优化，自定义 struct，枚举在 Lua 和 C# 间传递无 C# GC Alloc；\r\n* 编辑器下无需生成代码，开发更轻量；\r\n\r\n更详细的特性、平台支持介绍请参考 [xLua 文档: 功能特性](Assets\u002FXLua\u002FDoc\u002Ffeatures.md)。\r\n\r\n\u003Cbr\u002F>\r\n\r\n## 安装\r\n\r\nxLua 可以直接简单的安装在 Unity 项目中.\r\n\r\n1. 从 [Releases](https:\u002F\u002Fgithub.com\u002FTencent\u002FxLua\u002Freleases) 中下载发行版, 或直接下载本仓库代码.\r\n2. 打开下载下来的源码压缩包, 你会看到一个 Assets 目录, 这目录就对应 Unity 工程的 Assets 目录，保持这目录结构, 将其内容置入 Unity 项目即可.\r\n\r\n> 注意, Assets\u002FExamples 目录下为示例代码, 你应该在生产环境下删去他们.\r\n\r\n如果希望安装到其它目录，请看 [FAQ](Assets\u002FXLua\u002FDoc\u002Ffaq.md) 相关介绍。\r\n\r\n\u003Cbr\u002F>\r\n\r\n## 文档\r\n\r\n* (必看) [XLua 教程](Assets\u002FXLua\u002FDoc\u002FXLua教程.md)：教程，其配套代码[这里](Assets\u002FXLua\u002FTutorial\u002F)。\r\n* (必看) [XLua 的配置](Assets\u002FXLua\u002FDoc\u002Fconfigure.md)：介绍如何配置xLua。\r\n* [常见问题解答](Assets\u002FXLua\u002FDoc\u002Ffaq.md)：常见问题都总结在这里，初使用大多数问题都可以在这里找到答案。\r\n* [热补丁操作指南](Assets\u002FXLua\u002FDoc\u002Fhotfix.md)：介绍如何使用热补丁特性。\r\n* [XLua增加删除第三方lua库](Assets\u002FXLua\u002FDoc\u002FXLua增加删除第三方lua库.md)：如何增删第三方lua扩展库。\r\n* [XLua API](Assets\u002FXLua\u002FDoc\u002FXLua_API.md)：API文档。\r\n* [生成引擎二次开发指南](Assets\u002FXLua\u002FDoc\u002Fcustom_generate.md)：介绍如何做生成引擎的二次开发。\r\n\r\n\u003Cbr\u002F>\r\n\r\n## 快速入门\r\n\r\n一个完整的例子仅需3行代码：\r\n\r\n安装好xLua，建一个MonoBehaviour拖到场景，在Start加入如下代码：\r\n\r\n```csharp\r\nXLua.LuaEnv luaEnv = new XLua.LuaEnv();\r\nluaEnv.DoString(\"CS.UnityEngine.Debug.Log('hello world')\");\r\nluaEnv.Dispose();\r\n```\r\n\r\n1. DoString 参数为 string，可输入任意合法的 Lua 代码，本示例在 Lua 里调用 C# 的 UnityEngine.Debug.Log 打印了个日志。\r\n2. 一个 LuaEnv 实例对应 Lua 虚拟机，出于开销的考虑，建议全局唯一。\r\n\r\nC#主动调用 Lua 也很简单，比如要调用 Lua 的系统函数，推荐方式是：\r\n\r\n* 声明\r\n\r\n  ```csharp\r\n  [XLua.CSharpCallLua]\r\n  public delegate double LuaMax(double a, double b);\r\n  ```\r\n\r\n* 绑定\r\n\r\n  ```csharp\r\n  var max = luaEnv.Global.GetInPath\u003CLuaMax>(\"math.max\");\r\n  ```\r\n\r\n* 调用\r\n\r\n  ```csharp\r\n  Debug.Log(\"max:\" + max(32, 12));\r\n  ```\r\n\r\n注意, 请不要重复调用 `luaEnv.Global.GetInPath\u003CLuaMax>`, 这没有任何必要.\r\n\r\n\u003Cbr\u002F>\r\n\r\n## 热补丁\r\n\r\n除了使用 Lua 在 Unity 进行脚本编写, 你也可以使用 Lua 实现 \"热补丁\". xLua 提供了使用 Lua 逻辑替换 C# 方法逻辑的方案.\r\n\r\n* 侵入性小，老项目原有代码不做任何调整就可使用。\r\n* 运行时影响小，不打补丁基本和原有程序一样。\r\n* 出问题了可以用 Lua 来打补丁，这时才会走到 Lua 代码逻辑；\r\n\r\n参考使用指南: [xLua 文档: 热补丁](Assets\u002FXLua\u002FDoc\u002Fhotfix.md)\r\n\r\n\u003Cbr\u002F>\r\n\r\n## 更多示例\r\n\r\n* [01_Helloworld](Assets\u002FXLua\u002FExamples\u002F01_Helloworld\u002F): 快速入门的例子。\r\n* [02_U3DScripting](Assets\u002FXLua\u002FExamples\u002F02_U3DScripting\u002F): 展示怎么用 Lua 来写 MonoBehaviour。\r\n* [03_UIEvent](Assets\u002FXLua\u002FExamples\u002F03_UIEvent\u002F): 展示怎么用 Lua 来写 UI 逻辑。\r\n* [04_LuaObjectOrented](Assets\u002FXLua\u002FExamples\u002F04_LuaObjectOrented\u002F): 展示 Lua 面向对象和 C# 的配合。\r\n* [05_NoGc](Assets\u002FXLua\u002FExamples\u002F05_NoGc\u002F): 展示怎么去避免值类型的GC。\r\n* [06_Coroutine](Assets\u002FXLua\u002FExamples\u002F06_Coroutine\u002F): 展示 Lua 协程怎么和 Unity 协程相配合。\r\n* [07_AsyncTest](Assets\u002FXLua\u002FExamples\u002F07_AsyncTest\u002F): 展示怎么用 Lua 协程来把异步逻辑同步化。\r\n* [08_Hotfix](Assets\u002FXLua\u002FExamples\u002F08_Hotfix\u002F): 热补丁的示例（需要开启热补丁特性，如何开启请参考 [xLua 文档: 热补丁](Assets\u002FXLua\u002FDoc\u002Fhotfix.md)）。\r\n* [09_GenericMethod](Assets\u002FXLua\u002FExamples\u002F09_GenericMethod\u002F): 泛化函数支持的演示。\r\n* [10_SignatureLoader](Assets\u002FXLua\u002FExamples\u002F10_SignatureLoader\u002F): 展示如何读取经数字签名的lua脚本，参见[数字签名](Assets\u002FXLua\u002FDoc\u002Fsignature.md)的文档介绍。\r\n* [11_RawObject](Assets\u002FXLua\u002FExamples\u002F11_RawObject\u002F): 当 C# 参数是object时，如何把一个lua number指定以boxing后的int传递过去。\r\n* [12_ReImplementInLua](Assets\u002FXLua\u002FExamples\u002F12_ReImplementInLua\u002F): 展示如何将复杂值类型改为 Lua 实现。\r\n* [14_HotfixAsyncAwait](Assets\u002FXLua\u002FExamples\u002F14_HotfixAsyncAwait\u002F): 展示如何将异步函数和await关键字改为 Lua 实现。\r\n\r\n\u003Cbr\u002F>\r\n\r\n## 技术支持\r\n\r\n一群：612705778 (已满)\r\n\r\n二群：703073338 (已满)\r\n\r\n三群：811246782\r\n\r\n入群的问题：有问题该先从哪找答案\r\n\r\n回答：FAQ\r\n\r\n平时也要谨记这答案，90%以上问题都可以在[FAQ](Assets\u002FXLua\u002FDoc\u002Ffaq.md)里头找到答案。这些问题就别在群刷屏了。\r\n\r\n","xLua 是一个为 Unity、.Net 和 Mono 等 C# 环境提供 Lua 脚本编程能力的解决方案，支持 Android、iOS、Windows、Linux 和 macOS 等多种平台。其核心功能包括在运行时将 C# 实现替换为 Lua 实现、出色的 GC 优化以及无需生成代码的轻量级开发体验。xLua 特别适用于需要高效脚本执行和热补丁能力的游戏开发场景，能够显著提升开发效率并减少内存分配。",2,"2026-06-11 03:06:12","top_language"]