标签：des io ar 使用 sp java for strong 数据
可读性的大部分内容都是和代码缩进相关的，必须保证代码有良好的格式。可读性的另一方面就是注释，一般而言，有如下一些地方需要进行注释
每个函数或方法都应该包含一个注释，描述其目的和用于完成任务所可能使用的算法，陈述事先的假设也非常重要，如参数代表什么，函数是否有返回值等等
用于完成单个任务的多行代码应该在前面放一个描述任务的注释
如果使用了一个独特的方式解决某个问题，则要在注释中解释你是如何做的，这不仅仅可以帮助其它浏览你代码的人，也能在下次你自己查阅代码的时候帮助理解
因为存在浏览器差异，JavaScript代码一般会包含一些Hack，不要假设其他人在看代码的时候能够理解Hack所要应付的浏览器问题，如果因为某种浏览器无法使用普通的方法，所以你需要用一些不同的方法，那么请将这些信息放在注释中。
每行代码应小于 80 个字符。如果代码较长，应尽量选择换行，下一行代码应缩进4 个空格。这样可以使代码排版整齐，减轻阅读代码的疲劳感，以增强代码的可阅读性
JavaScript 语句应该以分号结束。但大多数浏览器允许不写分号，只要在本应是分号的地方有一个换行符就行。但是如果代码行较长需要换行的时候，有哪些注意事项呢？换行应选择在操作符和标点符号之后，最好是在逗号‘,‘之后，而不要在变量名、字符串、数字、或‘)‘ ‘]‘ ‘++‘ ‘--‘等符号之后换行。这样可以有效的防止拷贝、粘贴而引起的错误，并可有效地增强代码的可阅读性。
例如：var valueB = valueA ///bad
+1;
可以替换为：var
valueC = valueB + ///good
valueA;
我们会强调代码中注释数量的多少，而轻视了对注释质量的提高。编码是及时添加注释，会给后续代码的维护人员带来很大的便利。但是如果注释不注意更新，或者由于拷贝、粘贴引起的错误的注释，则会误导阅读人员，反而给阅读带来障碍，除了注释要及时更新外，我们还应对注释的内容要特别关注。注释要尽量简单、清晰明了，避免使用含混晦涩的语言，同时着重注释的意义，对不太直观的部分进行注解。
例如：
//following section is used to
initialize golbal variables
(good)
var valueA = 0; //initialize valueA to be sero (bad)
var valueB = 1;
...
//call f1 function after waiting for 50
seconds. (good)
setTimeout (f1,50000); //set timeout to be
20s (copy error)
大功能块的功能描述：
/*
*@desc:功能描述
*@param:参数描述
*@return:返回值
*/
建议使用4个空格来进行缩进
适当的空白行可以大大提高代码的可阅读性，可以使代码逻辑更清晰易懂。同时，在表达式中适当的留空白，也会给代码的阅读带来方便，关键字的后面如有括号，则最好在关键字和左括号‘(‘之间留空白，如 for, if, while 等。而函数名和括号之间则不宜留空白，但若是匿名函数，则必须在 function 和左括号‘(‘之间留空白，否则，编辑器会误认为函数名为 function。在表达式中，二元运算符 ( 除左括号‘(‘，左方括号‘[‘，作用域点‘.‘) 和两个操作数之间最好留空白。一元运算符（若不是词 typeof 等）和其操作数之间不宜留空白。逗号‘,‘的后面需要留空白，以显示明确的参数间隔，变量间隔等。分号‘;‘之后通常表明表达语句的结束，而应空行。在 for 的条件语句中，分号之后则应该留空白。
总结一句就是缩进和注释可以带来更可读的代码，还有就是用空行来将逻辑相关的代码块分割开可以提高程序的可读性，增加程序的可读性只为了在未来代码更容易维护。
JavaScript是严格区分大小写的，名称的也遵循以下规则：
每一行最多只包含一条语句，必须将分号放在简单语句的结尾外，虽然分号在JavaScript是可有可无了，但是为了压缩后不容易报错，强制性的必须每条js代码都得以分号结束
如car或person，如果是私有变量，则在名称前加_下划线
如getName()，返回布尔类型值的函数一般以is开始，如isEnable(),如果是普通函数，则第一个字母小写，如果是构造函数，则第一个字母大写。函数名与((左括号)之间不应该有空格。)(右括号)与 开始程序体的{(左大括号)之间应插入一个空格，}(右大括号)应该与函数名在同一行而不应该另起一行
不要担心长度，长度问题可以通过处理和压缩
因为JavaScript是弱类型（也叫松散类型）语言，很容易忘记变量所应包含的数据类型。使用匈牙利标记法来指定变量类型，匈牙利标记法就是在变量名之前加上一个或多个字符来表示数据类型。JavaScript中最传统的匈牙利标记法是用单个字符表示基本类型：“O”代码对象，“S”代表字符串，“I”代表整数，“F”代表浮点数，“B”代表布尔型。如下所示
var bFound; //布尔型
var iCount; //整数
var sName; //字符串
var oPerson; //对象
标签：des io ar 使用 sp java for strong 数据
原文地址：http://www.cnblogs.com/ctriphire/p/4109276.html
