Luau Type Expert 面向需要编写类型安全、可通过严格类型检查的 Luau 代码的场景,目标是在 Roblox 项目中以 --!strict 为默认写法完成类型标注与错误修复。
用途与适用场景:当你为 Luau 代码添加或修正类型注解、处理 luau-lsp 或 luau-analyze 报告的类型错误、推进 --!strict 合规、遇到“Type X could not be converted into Y”等报错,或需要处理泛型、联合类型等情况时可参考。
主要能力:
- 类型模式说明:覆盖 --!nocheck、--!nonstrict、--!strict 三种模式的行为差异,推荐在文件顶部使用 --!strict。
- 语法要点:包括变量、函数参数与返回值、可选类型 ?、多返回值、变参、表类型与类型别名;导出类型 export type;函数类型、泛型别名、字面量联合(可辨别联合)、交叉类型以及函数交叉(重载写法)。
- 类型收窄:通过 type()、typeof()、真值判断与相等比较在条件分支中收窄类型;并说明提前 return 后可保留收窄结果的写法。
- 类型断言:使用 :: 覆盖推断类型,并提示断言的约束条件(一个操作数必须是另一个的子类型,或为 any)。
- 泛型:泛型函数、带约束的泛型、泛型类型别名与多类型参数示例。
- 元表与 OOP:给出带类型定义的类实现模式,包括 __index、构造与方法的类型标注。
- 常见类型错误与修复:列出“无法转换类型”“未知全局”“属性不兼容”“W_001 未知 require”等问题的处理方向。
- 工具与配置:luau-lsp analyze 的命令行用法(含 sourcemap、definitions、--no-flags-enabled 参数)以及 .luaurc 的 languageMode、lint、aliases 配置示例。
- 性能相关写法:建议使用 table.field 而非 table["field"]、保持元表浅层、把内置函数本地化、避免 getfenv/setfenv、已知大小时使用 table.create(n)。
- lint 规则:提供 28 条 lint 规则的参考,并点出 UnknownGlobal、LocalUnused、ImplicitReturn、UninitializedLocal 等关键规则。
使用方式:该技能以参考文档形式组织,包含 api_reference.md、common-errors.md、performance.md、lint-rules.md 等参考资料;实际类型检查可通过 luau-lsp analyze 对源码目录执行,并可结合 sourcemap、definitions 参数适配 Roblox 项目与全局类型定义。
限制:资料未提供安装命令、许可、价格、平台支持范围与效果保证等信息,相关内容暂未提供。