roblox-luau-core 是一套关于 Roblox Luau 核心语言的技能资料,用于在编写、编辑或调试任何 Luau 代码时提供语义参考,尤其面向从 JavaScript 或 Python 迁移过来的开发者。
用途
该技能聚焦 Luau 语义以及 JS/Python 的翻译对照。资料指出:类型相关内容应参考 roblox-luau-types,生命周期相关内容参考 roblox-luau-patterns,引擎 API 则归入领域技能。
主要能力
资料提供了一份快速参考,涵盖以下核心规则:
- 真值判断:只有 false 和 nil 为假;0、空字符串和空表均为真。
- 相等比较不做类型强制:0 == "0" 为假;不等号写作 ~=。
- 数组约定从 1 开始;#array 仅对没有 nil 空洞的序列有意义。
- 表行为:赋 nil 会移除键;赋表复制引用;table.clone 是浅拷贝。
- 字典迭代顺序未定义,不应让行为依赖该顺序。
- 动态键需要用方括号:record[field];点语法使用字面标识符。
- 缺失参数会变成 nil;多余的结果和参数可以丢弃。
- 当 a 可能为假值时,优先使用 if 表达式而非 condition and a or b。
- 局部变量从声明处开始生效;repeat 的局部变量作用域延伸到 until。互递归需要前向声明。
- Luau 字符串模式不是正则表达式,语法与能力均不同。
- 反引号插值和 .. 均可用。在热循环中应将大量片段一次性拼接。
- NaN 不等于自身,也会破坏 < 与 > 比较;可用 x ~= x 检测。
- 二进制数据使用 buffer 库:固定大小、0 基偏移、显式宽度的读写。避免使用 buffer.readinteger/writeinteger(桩实现,非已发布的运行时)。
- Base64、哈希或压缩使用 EncodingService(操作 buffer 而非字符串;JSON 通过 HttpService)。详细内容见完整参考。
资料给出的代码示例包括:
local label = if enabled then "On" else "Off"
local message = {name}: {score}
local byId: {[number]: string} = {} byId[userId] = name
for index, value in values do print(index, value) end
翻译陷阱
资料列出了跨语言翻译时需要注意的差异:
- JavaScript 的 ===、!==、null、可选链、展开、箭头函数和数组方法都不是 Luau 语法。
- Python 的 None、零基列表假设、列表推导式、异常以及隐式元组行为不能直接照搬。
- x or fallback 测试的是真值,而不仅是缺失;它会替换掉有效的 false 值。
- typeof(value) 识别 Roblox 数据类型;type(value) 报告底层的 Luau 类型类别。
审查要点
资料建议检查:合法的 Luau 代码、没有 nil 空洞、不假设字典顺序、没有意外别名、没有跨语言语法、没有会掩盖 false 或 nil 的 fallback。
限制
该资料未提供安装命令、收费信息、平台支持或具体使用步骤;上述细节以资料给出的语义规则为准。更详细的语言陷阱与翻译示例见 references/full.md。