Luau 类型系统技能说明。
适用时机:在需要处理 Luau 类型标注、类型推断、类型收窄、严格度设置、类型导出和求解器相关特性时加载。语法方面参考 roblox-luau-core;生命周期与调度方面参考 roblox-luau-patterns。
严格度:维护中的代码使用 --!strict,过渡期使用 --!nonstrict,仅对遗留代码或生成代码使用 --!nocheck。模式由指令和项目设置决定,不要假定存在某个全局默认值。
新求解器门槛:keyof、rawkeyof、setmetatable<T, M>、类型函数以及 read 成员需要新类型求解器。nocheck 与 nonstrict 项目默认开启;strict 项目需要设置 Workspace.UseNewLuauTypeSolver = Enabled(Scripting)。此处报错通常意味着求解器不对,而非语法错误。
推断理念:优先推断;只在边界(参数、返回值、导出)做标注,不必对每个局部变量都标注。
封闭表与非封闭表:未标注的局部表在被标注、从函数返回或其作用域结束之前,始终对新字段开放;标注会使其封闭。应在表完全构建之后再标注;把表传给带类型的函数并不会使其封闭。
联合类型:local id: string | number 是联合类型;优先使用带标签联合(type State<T> = {kind:"loading"} | {kind:"ready", value:T}),并按 kind 判别来收窄。
收窄:typeof、IsA、断言和带标签的判别式都能细化类型;示例见 full.md。
缺失键:当查找可能落空时使用 { [K]: V? },使用前先收窄。
封闭词汇表:优先使用字面量联合;never 检查可标记出缺失分支。保持 require 可静态解析。实践建议见 full.md。
泛型:当输入与输出的类型关系重要时使用,例如 function first<T>(list: {T}): T?,或 type Result<T> = {success: boolean, value: T?}。不要用 any 替代。
类型导出:在模块边界使用 export type Foo = {...};使用者通过 Types.Foo 引用。
对象类型:typeof(setmetatable({} :: CounterData, Counter)) 可精确描述 self;新求解器直接支持 setmetatable<T, M>。
类型转换(::):用于收窄过于宽泛的推断,绝不用于掩盖错误。
信任边界:类型标注是与编译器之间的契约,而非对运行时数据的保证。Remotes、DataStore、HttpService 和 attributes 仍需检查;在可信边界内部,可让类型承担职责。
审查要点:不得出现隐藏的 any、过早封闭、未检查的类型转换,或无视求解器的改写。
完整参考:见 references/full.md。