北大方正数字出版开发部第页共NUMPAGES5页产品编码规范书北京北大方正集团公司北京大学计算机科学技术研究所2001年03月一、语言选择服务器端脚本尽量使用JavaScript，原因在于VBScript的错误处理会影响代码的可读性.二、书写格式代码书写格式整齐统一、、层次清晰便于阅读。缩进TAB键统一为4个空格赋值语句(=)及逻辑判断符(><!=&&||...etc)左右各空一格算术运算符左右各空一格if/while/switch之类的语句右边空一格每个成员函数内部各个子功能之间用一个空行公用成员放在程序的最前面，私用成员在后。三、恰当地使用注释注释应简洁、清楚。不提倡使用/*和*/来注释,最好使用//来注释。如果是对某一段程序(算法/结构)的注释,在程序头直接用//再空一格来进行说明,一行不要超过80字符注释就占程序的30%，如10行代码中就有不小于3行的注释。四、关于命名1、变量必须显式定义如果使用VBScript,使用变量前必须显式定义。虽然VBScript支持变量不定义就直接使用,但使用未经定义的变量可能会导致不可预知的错误。可以在asp文件的所有执行代码前添加<%OPTIONEXPLICIT%>强制要求变量定义.2、变量的命名除了循环变量i,j,k...之外，文件、类、(成员)变量、(成员)函数的命名要有意义，大小写相间，一目了然；成员变量、函数(Method)的首字母小写全局变量名称以“g_”开头。3、匈牙利命名法命名时可以遵循匈牙利命名法它通过在数据和函数名中加入额外的信息以增进程序员对程序的理解。如字符串,前面加上str;.varstrTemp=“Thisis……”；i----->intu----->UINTw----->WORDdw----->DWORDb----->BOOLby----->BYTEch----->CHARsz----->CHARARRAYstr----->STRINGl----->LONGf----->floatd----->doubleq----->SINT64uq----->UINT64v----->voidfn----->functionh----->HANDLErect----->RECT,CRectpt----->POINT,Cpointo---->objecttxt---->textboxchk---->checkboxrdo--radiocbo---->select(dropdown)lst---->select(list)div---->DIVpwd---->passwordtbl---->tablefra--frameconn--ADODB.CONNECTIONrs--ADODB.RECORDSET五、局部变量一定要初始化如果你声明一个变量，不要以为编译器会自动将之赋零值！你随手给它赋个初值并不麻烦，却会使程序更可靠，varfTemp=0.0;六、.成员函数：成员函数的功能一定要单一；实现其功能时不要过分追求技巧，函数体不能过长七、.数组和缓冲区的使用对数组和缓冲区进行检查，防止越界，尤其是变长的情况下八、.尽量不要用goto语句特别谨慎使用goto语句，最好别用它尽管goto语句在某些特殊的情况下（比如编译器中）还很管用,但它破坏了整个程序的结构，尤其使用goto嵌套时，更让人一头雾水(很久以前就有人提出取消它)。所以不到万不得已时刻不要用它，可以用break,continue之类的语句替代之。九、函数应该是单人口、单出口的所有成员函数尽量是单入口,单出口也许多出口的程序写起来更简洁，意义也更明了。但出了问题调试时会很难定位，所以宁可多用一些BOOL变量，多加些判断，保证单出口：十、调用函数应合法调用函数时要严格按照接口规范严格按照函数的输入要求给它合适的参数十一、.单元测试自己做代码内部(单元)测试时，必须做到语句覆盖，并且特别要注意边界值的覆盖要让每个语句都被执行过，并且边界值(最大和最小)也被测试过。你在程序中写的各种情况都可能在用户那里出现十二、静态检查代码写完后要尽可能多的做一些静态检查(Debug调试可是很费神费时的)。尤其是对算法和数据管理（比如对文件存取）部分十三、文件存放代码文件的存储位置固定，图片文件存放在统一的目录Image下，如果各个模块有自己的图片文件，可以创建子目录来完成。公用函数脚本文件放在统一的目录Jslib下。公用模块文件放在统一的目录common下。每个功能模块创