SuperAPI AI 工具集

roblox-luau-core

编程与开发

查看项目

更新于 10-16 10:41

技能介绍

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。