lua-basics

该技能用于在 FiveM 资源中编写或评审 Lua 代码，或在用户询问 Lua 命名、结构、性能、表与错误处理时启用。主要能力是提供一套惯用且高性能的 Lua 模式与规则，覆盖函数、表、变量、条件与错误。硬性规则包括：常量用 ALL_CAPS，局部变量用 camelCase，全局变量用 PascalCase，未使用变量用 _；优先使用 local，并尽量靠近首次使用处声明，文件级全局变量集中在单个 client/server 文件顶部；不要使用 table.insert，改用 t[#t + 1] = v 或自行维护大小计数；用数值 for i = 1, #t 遍历数组，数组索引尽量隐式写出；把重复的表解引用提取为局部变量，常量键用 t.key，动态键用 t[var]；使用守卫子句和提前返回，避免 if x then return true else return false end；优先正向布尔表达式，用 value = value or default 设默认值；用 assert 做前置条件而非 if not x then error() end，对意外状态要大声失败，对可预期失败以返回值传递错误；限制参数数量，API 避免布尔参数（改用枚举），传具名局部函数而非内联函数；保持函数小、单一抽象层级，并为导出写文档。使用方式：按上述规则应用到每个标识符，用守卫子句替换嵌套 if，用索引写入和数值循环替换 table.insert 与数组上的 pairs，在函数入口添加 assert 前置条件，并复查函数大小，拆分混合高低层代码的函数。输出应遵循这些命名、局部性、表和错误处理规则，对有意偏离需加注释。参考资料包括 rules/functions.md、rules/tables.md、rules/variables.md、rules/conditionals.md、rules/errors.md、rules/reference-links.md，上游文档为 https://www.lua.org/manual/5.4/。适用场景为 FiveM 资源的 Lua 开发与代码评审。限制：资料未提供具体收费、平台支持范围或效果数据，暂未提供。