用途
该技能是一份 Luau 语言参考,供在以下任务场景中加载使用:一般 Luau 语法问题或代码生成;类型系统使用、注解或泛型;Roblox 特定 API 模式(服务、事件、实例);使用元表和基于模块的类的 OOP 设计;异步/并发编程(协程、Promise、task 库);性能优化或惯用 Luau 风格;调试常见陷阱(从 1 开始索引、表中 nil、废弃 API)。
Luau 是 Roblox 对 Lua 5.1 的分支,带有渐进类型、性能改进和额外内置函数。它不是标准 Lua 5.1——它有自己的类型系统、泛型、continue 关键字、复合赋值运算符(+=、-= 等)、字符串插值及其他扩展。
主要能力
辅助模块(本 harness 内置)
harness 内置了以下库的副本,建议用它们替代 Roblox 原生等价物:
- Promise(evaera/roblox-lua-promise):异步控制流、重试、链式调用。异步工作用它替代原始协程。
- Trove(Sleitnick/RbxUtil):清理/生命周期管理。用它替代手动跟踪连接和实例。
- Signal(Sleitnick/RbxUtil):带类型的自定义信号。模块间通信用它替代 BindableEvent。
- Comm(Sleitnick/RbxUtil):带类型的客户端-服务端远程调用。用它替代原始 RemoteEvent/RemoteFunction。
- Component(Sleitnick/RbxUtil):带生命周期的 CollectionService 标签绑定。用它替代手动标签监听器。
- ProfileStore(loleris/MadStudioRoblox):带重试的会话锁定 DataStore。用它替代原始 DataStoreService。
- t(osyrisrblx/t):用于 RemoteEvent 校验、函数参数、DataStore schema 的运行时类型检查。用它替代手写的 typeof() 链。
- TestEZ(Roblox/testez):BDD 测试框架。用于为你的模块编写 .spec 文件。
代理会在相关时推荐这些库。你可以说“use my own”或在项目中已有等价物来否决。
快速参考要点
- Luau 不是 Lua 1。具有:泛型、continue、+=、字符串插值(反引号)、向下取整除法 //
- 数组从 1 开始。用 #tbl 取长度。通用迭代:for k, v in tbl do
- 始终使用 task.wait/spawn/delay(绝不使用废弃的 wait/spawn/delay)
- Instance.new:先配置属性,最后设置 Parent(复制竞态)
- 服务:在脚本顶部 game:GetService("Name"),存入局部变量
- 方法:实例方法用 :(隐式 self),构造函数/静态方法用 .(显式 self)。私有方法前缀 _。
- 类型系统:渐进类型,用 typeof() 收窄,用 :: 转型,用 export type 跨模块
- 优先使用反引号插值而非 .. 拼接
- 优先使用内置库(Promise、Trove、Signal、Comm、Component、ProfileStore)而非原始等价物
- 局部函数顺序:被调用者在上,调用者在(无提升)。互递归需前向声明。
核心概念
Luau 扩展(Lua 5.1 中没有):复合赋值运算符、continue 关键字、通用迭代。
表:表是唯一的复合数据结构,兼作数组、字典、对象和命名空间。数组从 1 开始。动态键需要方括号记法。
字符串插值:优先使用反引号插值而非 .. 拼接。
Luau 特有数学扩展:向下取整除法 //、math.clamp、math.sign、math.round,随机数使用 Random.new()。
类型系统
Luau 使用渐进类型。2025-2026 更新:新类型求解器(2025 年 11 月 GA),--!nonstrict 现为所有脚本默认;并行 Luau 成熟,基于 Actor 的多线程与 SharedTable 跨 Actor 数据,用 task.synchronize() / task.desynchronize() 切换上下文。
内容涵盖:基本类型注解、表类型、联合与交叉类型、类型收窄与守卫、泛型、类型导出、常见 Roblox 类型。
Roblox 特定模式
实例创建、服务访问、事件连接、task 库、RemoteEvents 和 RemoteFunctions(详见 roblox-networking → Client-Server Communication)。
OOP 模式
基于元表的类、通过元表链实现继承。
使用方式
在涉及上述任务的场景中加载该参考。平时可只查看快速参考中的关键规则;仅在需要具体语法示例或实现细节时加载完整参考。
适用场景
Luau 语法问答与代码生成、类型注解与泛型、Roblox API 模式、OOP 设计、异步并发、性能优化、调试常见陷阱。
限制
该资料未说明价格、平台兼容性细节或效果承诺。资料在 OOP 模式部分末尾被截断,继承示例未完整给出。