多行注释

对于长度为几行的注释，可以使用多行注释（又称"块注释"）。开发人员通常使用多行注释描述文件、数据结构、方法和文件说明。它们通常放在文件的开头和方法的前面或内部。

要创建注释块，请在注释行开头添加 /*，在注释块末尾添加 */。此方法允许您创建很长的注释，而无需在每一行的开头都添加 //。若对多个连续的行使用 //，在修改注释时可能会产生一些问题。

多行注释的格式如下。

/*
    The following ActionScript initializes variables used in the main and sub-menu systems. Variables are used to track what options are clicked.
*/

提示

如果将注释字符（/* 和 */）置于注释开头和结尾处的独立的行上，则通过在注释字符之前放置双斜杠字符 (//) 可以很容易地将这些注释字符注释掉（例如，///* 和 //*/）。这些使您能够快速且容易地对代码进行注释和取消注释。

通过将大段脚本放在注释块中（称为注释掉 部分脚本），您可以测试脚本的特定部分。例如，当以下脚本运行时，将不执行注释块中的任何代码：

// 以下代码运行。
var x:Number = 15;
var y:Number = 20;

// 以下的代码被注释掉了，将不会运行。
/*
// 创建新的 Date 对象
var myDate:Date = new Date();
var currentMonth:Number = myDate.getMonth();
// 将月份数转换为月份名称
var monthName:String = calcMonth(currentMonth);
var year:Number = myDate.getFullYear();
var currentDate:Number = myDate.getDate();
*/

// 以下代码运行。
var namePrefix:String = "My name is";
var age:Number = 20;

提示

注释块前面留出一个空行是一种很好的做法。

查看 LiveDocs 上的注释