此外，JavaScript 的注释有两种"//" 和"/* .... */"，建议"//"用作代码行注释，"/* .... */"形式用作对整个代码段的注销，或较正式的声明中，如函数参数、功能、文件功能等的描述中。

标识符命名

JavaScript 中的标识符的命名规则：

• 以字母、下划线'_'或美元符号'$'开头
• 允许名称中包含字母，数字，下划线'_'和美元符号'$'
• 区分大小写

变量、参数、成员变量、函数等名称均以小写字母开头，构造器的名称以大写字母开头。下划线'_'开头的变量一般习惯于标识私有 / 局部成员。而美元符号'$'开头的变量习惯于标识系统相关，比如系统进程等。应避免用下划线'_'或美元符号'$'来命名标识符。尽可能地降低代码的阅读负担。

声明

变量的声明

尽管 JavaScript 语言并不要求在变量使用前先对变量进行声明。但我们还是应该养成这个好习惯。这样可以比较容易的检测出那些未经声明的变量，避免其变为隐藏的全局变量，造成隐患。

在函数的开始应先用 var 关键字声明函数中要使用的局部变量，注释变量的功能及代表的含义，且应以字母顺序排序。每个变量单独占一行，以便添加注释。这是因为 JavaScript 中只有函数的 {} 表明作用域，用 var 关键字声明的局部变量只在函数内有效，而未经 var 声明的变量则被视为全局变量。我们来看下清单 3。

清单 3. 局部变量声明

<script language="javascript">
 var valueA  = "a";
 var valueB  = "b";
 function f1() {
   var valueA = "c";
   alert("valueA="+valueA);        //output: valueA=c
   valueB = "d";
   alert("valueB="+valueB);        //output: valueB=d
 }
 f1();
 alert("valueA="+valueA);            //output: valueA=a
 alert("valueB="+valueB);            //output: valueB=d
 </script>

从上例的输出惊奇地发现，用 var 声明过的变量 valueA 和没有声明的变量 valueB 是有区别的。特别需要注意的是，在函数内部用 var 声明的变量为局部变量，这样可以有效地避免因局部变量和全局变量同名而产生的错误。

函数的声明

函数也应在调用前进行声明，内部函数应在 var 声明内部变量的语句之后声明，可以清晰地表明内部变量和内部函数的作用域。

此外，函数名紧接左括号'('之间，而右括号')'和后面的'{'之间要有个空格，以清楚地显示函数名以其参数部分，和函数体的开始。若函数为匿名 / 无名函数，则 function 关键字和左括号'('之间要留空格，否则可能误认为该函数的函数名为 function。

清单 4. 内部函数声明

<script language="javascript">
 var innerA = 1;
 function outF() {
   var innerA = 2;
   function _inF() {
       alert("valueA="+innerA);
   }
   _inF();
 }
 outF();                         //output: valueA=2
 _inF();                         //error: innerF is not defined
 </script>

从清单 4 的输出可以看出，inF() 函数仅在 outF() 函数的内部生效，局部变量 innerA 对内部函数的作用域生效。这样的编码方式使得变量和函数的作用域变得清晰。

出处：ibm
责任编辑：bluehearts

上一页 浅谈JavaScript编程语言的编码规范 [2] 下一页 浅谈JavaScript编程语言的编码规范 [4]

◎进入论坛网页制作、WEB标准化版块参加讨论，我还想发表评论。