腾讯编码规范

《腾讯编码规范》由会员上传分享，免费在线阅读，更多相关内容在学术论文-天天文库。

1、Tencent腾讯集团管理标准GL/YF013—2007V1.0—L1Java编码规范2007-09-11发布2007-09-11实施腾讯集团发布f—1—冃IJ吕木标准系公司首次发布实施，主要针对公司所有软件产品源代码范ffl的Java编码风格，对Java文件的文件组织、代码风格、注释、命名、声明、异常、习惯等方面均作出规范，以保障公司项目代码的易维护性和编码安全性。本标准由研发管理部、3G产品中心共同制定。本标准主耍起草人：Junjim（张莉琚）、Imn（邱会发）木标准主要宙核人：anwenfcngG马文信）、Paulinesong（宋虹漫）、Ericlin（林松）、S

2、tevezheng（郑全战）、Junehuang（黄俊）、Kevinxu（许冠严）、polo（陈广域）、leon（郭凯天）本标准批准人：jeffxiong（熊明屮）、charles（陈一丹）、tony（张志东）、ponyma（马化腾）木标准首次发布日期：2007年9月11曰本标准发送部门：公司各部门JAVA编码规范1目的为形成公司统一的Java编码风格，以保障公司项目代码的易维护性和编码安全性，特制定木规范。2适用范围木标准适用于腾讯集团（含分公司等各级分支机构）所宥使用Java作为幵发语言的软件产品。木标准中“腾讯集团”是指腾讯控股宥限公司、其附属公司、及为会计而综合入

3、账的公司，包括但不限于腾讯控股有限公司、深圳市腾讯计算机系统宥限公司、腾讯科技（深圳）宥限公司、腾讯科技（北京）宥限公司、深圳市世纪凯旋科技宥限公司、时代朝阳科技（深圳）宥限公司、腾讯数码（深圳）宥限公司、深圳市财付通科技宥限公司。3总体原则所有使用Java作为开发语言的软件产品都须遵照本规范的内容进行编码。4文件组织4.1规则4.1.1由于超过2000行的程序难以阅读，应该尽量避免出现超过2000行的程序；4.1.2—个Java源文件都包含一个单一的公共类或接I」。若私宥类和接I」与一个公共类相关联，可以将它们和公共类放入同一个源文件。公共类必须是这个文件中的第一个类或

4、接U。4.2组织顺序4.2.1文件注释（参见’’6.1文件注释4.2.2毡和引入语句：在多数Java源文件中，第一个非注释行是语句。在它之后可以跟引入语句；4.2.3类或接口注释（参见’’6.2类或接口注释"）；4.2.4类或接口的声明；4.2.5类或接口的实现注释：如果有关类或接口的信息不适合作为“类或接口文档注释”,可以在类或接口的实现注释中给岀；4.2.6类的（静态）变量：首先是类的公共变量，随后是保护变量，再后是铋一级别的变量（没有访问修饰符），最后是私有变量；4.2.7实例变量：首先是公共级别的，随后是保护级别的，再后是钮一级别的（没有访问修饰符），最后是私有级

5、别的；4.2.8构造方法；4.2.9方法：方法应该按功能分组，而不应该按作用域或访问权限进行分组。4.3范例直接査看以卜*文件可以找到编码套用的规则：（注：可以通过复制粘贴保存到硬盘）5代码风格5.1缩进5.1.1程序块耍采用缩进风格编写，缩进只使用TAB键，不能使用空格键（编辑器屮请将TAB设置为4格）；5.1.2方法体的开始、类的定义、以及if、for、do、while、switch、case语句中的代码都耍采用缩进方式；5.2对齐5.2.1程序块的分界符左大括号”{”和右大括号都另起一行，应各独心一行并且位于同一列，同时与引用它们的语句左对齐；5.2.2对齐只使用T

6、AB键，不使用空格键；5.2.3不允许把多个短语句写在一行中，即一行只写一条语句；5.2.4if、for、do、while、case、switch、default等语句自占一行。5.3换行一行的K度超过80个字符需要换行，换行规则如下：5.3.1在一个逗号后面断开；5.3.2在一个操作符前面断开；5.3.3K表达式要在低优先级操作符处划分新行；5.3.4新行缩进2个TAB。5.4间隔5.4.1类、方法及和对独立的程序块之问、变量说明之后必须加空行；5.4.2关键字之后要留空格，象if、for、while等关键字之后应留一个空格再跟左拈号"(’’，以突出关键字；5.4.3方

7、法名与其左拈号”(”之问不要留空格，以与关键字区别；5.4.4二元操作符如，，=■■、，■+=’，，，〉=，，、，，＜=”、，，+•■、”*”、■■%•■、，■&&.■、"『、”«，，，•，AH等的前后应当加空格；5.4.5—元操作符如〜”等前后不加空格；5.4.6象”这类操作符前后不加空格；5.4.7for语句中的表达式应该被空格分开，如：for(exprl;expr2;expr3)5.4.8强制转型肜成该跟一个空格，如：myMethod((byte)aNum,(Object)x)6注释原则：——对已经不推荐使用的类和方法需