JX3-QASTD-LuaScriptSpecificationVerify.docVIP

剑三项目组脚本规范 创建时间 ：2008-7-18 编写者 ：竺成敏、潘松、侯锐 说明 ： 本规范旨在促进脚本编写人员编写风格统一、易于维护的脚本，防止脚本缺陷出现。 本规范将作为脚本测试中缺陷判定的依据，凡不符合规范之处，测试人员均可视其为缺陷。 格式 脚本头注释要写到脚本文件的起始部分。 脚本头注释的格式依据编辑器自动生成的格式为准。 语句间的缩进，用“Tab”，而不能使用多个空格。 代码分隔符的空格： ??(向后紧跟，)、,、;向前紧跟，紧跟处不留空格。 例如：function(x, y, z); --正确 function( x, y, z); --错误，(应向后紧跟 function(x, y, z ); --错误，)应向前紧跟 function(x , y , z); --错误，,应向前紧跟 function(x, y, z) ; --错误，;应向前紧跟 ??,之后要留空格。 例如：function(x, y, z) ??[]、.这类操作符前后不加空格。 双目运算符前后都要有空格。如：字符串连接符.. 每行字符数目要便于阅读，跨行采用左缩进。参数较多的函数可以写成如下形式： player.OpenWindow( --左括号要紧靠函数名 TARGET.NPC, npc.dwID, --缩进一个tab tIdleTalk[0] .. --标点写在上一行 npc.GetQuestString() ) --右括号不缩进 不允许超过两行以上的连续空行。 块内的首行和末行不能有空行。 例如：do --⑴ print(“Hello”) print(“World!”) --⑵ end 上面代码中，⑴、⑵处的空行多余。 脚本中的注释要和当前块的缩进保持一致。 if语句不能独占一行。 反面教材： if player.dwID == 1 then player.dwID == 2 end -- 禁止这样写 如果多个条件的if语句需要折行，必须参照以下格式 例如：if player.dwID == 1 and player.dwID == 1 --注意and的位置！ and player.dwID == 1 then --注意then的位置 player.dwID = 2 end 命名规则 函数名用大写字母开头的单词组合而成，以单词开头的大写字母分隔每个单词，禁止用下划线‘_’分隔。 变量名用小写字母开头的前缀+大写字母开头的名称组合而成。为了编辑器能正常工作，以下类型的变量必须以指定的字符做前缀： Table： 前缀t。 Number： 前缀dw（非负整数）、n（整数）、f（浮点数）。 Boolean： 前缀b。 String： 前缀sz。 NPC： 前缀npc。 Player： 前缀player。 Doodad： 前缀doodad。 Shop： 前缀shop。 Scene： 前缀scene。 Item： 前缀item。 Skill： 前缀skill。 Cell： 前缀cell。 Buff： 前缀buff。 Const： 全大写。 标识符要有意义且拼写正确，有意思且与实际用处相符，尽量避免缩写。一般情况下不能使用拼音，但人名、地名、成语类除外。 变量定义时，避免使用全局变量。即局部变量前的local一定要写。 游戏内容相关的字符，必须使用全角或标签字符开始，空格要使用全角空格。其他字符串必须以半角字符开始。 例如： 字符串scripts/map/洛阳/npc/放老虎的npc.lua不会被纳入ls表，也不能作为游戏内容用在say函数里面。 NPC别名必须使用半角字符。 常量 游戏逻辑导出的常量表，以及势力ID、生活技能ID、CHARACTER_ACTION不能直接用魔法数字，要使用常量表示。 自定义变量的编号必须在头文件中建立常量表后再使用。 变量 变量使用前必须先赋值，禁止操作未赋值的变量。 局部变量的作用域必须在当前块内被用到。 例如： if condition1 then local nCount = 0 Do Something --未使用到变量nCou