极力建议使用注释将备注添加到脚本。注释有助于理解您关注的内容,如果您工作在一个合作的环境中或者要提供范例,注释还有助于向其他开发人员提供信息。如果在创建脚本时进行注释,即使简单的脚本也会更易于理解。
若要指示某一行或一行的某一部分是注释,请在该注释前加两个斜杠 (//
):
on (release) { // 创建新的 Date 对象 myDate = new Date(); currentMonth = myDate.getMonth(); // 将月份数转换为月份名称 monthName = calcMonth(currentMonth); year = myDate.getFullYear(); currentDate = myDate.getDate(); }
如果启用了语法颜色(请参见语法突出显示),注释在默认情况下为灰色。注释可以具有任意长度,这不会影响导出文件的大小,并且它们不必遵循动作脚本语法或关键字的
规则。
如果要“注释掉”脚本的整个部分,请将其放在注释块中,而不是在每行开头添加 //
。这种方法更为简单,当您要注释掉脚本的大块代码以仅测试脚本的某些部分时,它非常有用。
若要创建注释块,请在命令行开头添加 /*
,在末尾添加 */
。例如,当以下脚本运行时,将不执行注释块中的任何代码:
// 运行以下代码 var x:Number = 15; var y:Number = 20; // 不运行以下代码 /* on (release) { // 创建新的 Date 对象 myDate = new Date(); currentMonth = myDate.getMonth(); // 将月份数转换为月份名称 monthName = calcMonth(currentMonth); year = myDate.getFullYear(); currentDate = myDate.getDate(); } */ // 运行以下代码 var name:String = "My name is"; var age:Number = 20;