常见问题
按主题分类；未覆盖的问题见 排错指南 或 GitHub Issues。
一般
ZLua 与 xLua 有什么区别？
ZLua 在 Il2Cpp 内嵌 Lua、C++ 直桥，不生成 C# Wrap。类型访问用 CSharp 根表，C# 调 Lua 用 [LuaInvoke]。选型理由见 为什么选择 ZLua；架构与理论性能见 与 xLua 对比；迁移见 迁移对照草稿。
Mono 和 Il2Cpp 差别有多大？
Mono（Editor） 已实现 v1.0 全量功能；Il2Cpp（Player） 仅 MVP（Demo 级基础互操作）。见 项目状态 与 兼容性。
正式版什么时候发布？
Il2Cpp 完整实现与性能优化预计 2026 年 8 月。见 路线图。
当前适合上生产吗？
Editor 开发验证 可以；Il2Cpp Player 仅适合 MVP 已覆盖的 Demo 级场景，勿假设全功能可用。
支持哪些 Unity / Lua 版本？
验证环境 Unity 2022.3 LTS + Lua 5.4。更多平台见 兼容性。
安装与工程
如何安装 ZLua？
UPM Git URL："com.code-philosophy.zlua": "https://github.com/focus-creative-games/zlua.git"。详见 安装与集成 与 zlua-demo。
Lua 脚本放哪里？
推荐项目根 LuaScripts/*.lua（Editor），Player 用 Sync 到 StreamingAssets/LuaScripts/*.lua.txt。
为什么用 .lua.txt？
避免 Unity 对 .lua 的导入规则冲突；Player 从 StreamingAssets 读取文本。
必须用 zlua-demo 吗？
不是必须，但文档示例以它为 canonical；建议对照其 Bootstrap、Sync 脚本与目录结构。
多个 Lua 模块怎么组织？
每个文件 return { ... } 表；[LuaInvoke("mod","fn")] 的 module 名对应 LoadLuaModule("mod")。见 Lua 模块加载。
类型与语法
含 namespace 的类型怎么访问？
CSharp.AC['MyGame.UI.Panel']，不能链式 CSharp.AC.MyGame.UI.Panel。
程序集名是什么？
默认游戏脚本为 Assembly-CSharp，常设别名 CSharp['AC'] = CSharp['Assembly-CSharp']。
Lua 能访问 private 成员吗？
不能，仅 public 成员。未注册成员 strict miss 直接报错。
泛型类型怎么用？
zlua.make_generic_type 闭合后再构造。见 泛型与数组。
enum 在 Lua 里是什么类型？
默认 integer/number；也可 _ctor 构造 enum userdata。见 enum 与 struct。
互操作
如何从 C# 调用 Lua？
[LuaInvoke("module","method")] + static extern。见 C# 调用 Lua 与 LuaInvoke 参考。
方法重载怎么选？
默认 dispatch；热路径用 [LuaAlias] 或 zlua.get_method。见 方法重载。
Lua 如何传回调给 C#？
直接传 function，delegate 形参隐式 marshal。见 回调与 Delegate。
Event 怎么订阅？
eventTable.get(obj, handler) / 静态 get(handler)。见 Event。
ref / out 怎么用？
zlua.new_ref(T)，不要传裸数字 expecting 回写。见 ref / out / in。
struct 修改为什么没生效？
可能传的是拷贝语义（裸 table/number）而非 StructUserData / new_ref。见 enum 与 struct。
[LuaMarshalAs] 何时需要？
默认编组不够时（如 byte[] 当 Lua string、struct 临时 opaque）。见 LuaMarshalAs 参考。
Player / 发布
Editor 正常 Player 失败？
多半是使用了 Il2Cpp MVP 未支持的功能（泛型、Event、ref 等）。见 排错指南 与 Editor vs Player。
Player 性能如何？
当前 MVP 不能代表设计目标性能；完整 Il2Cpp 版发布后再评估。见 性能报告。
发布前要检查什么？
调试与支持
从哪里找示例代码？
zlua-demo 为 canonical 工程。
如何跑官方测试？
ZLuaTest 工程 TestScene → Play；见 测试框架。
如何报告 Bug？
GitHub Issues 或 联系（QQ 群 / Discord）。
想贡献代码 / 文档？
见 贡献指南。