腾讯代码风格

 

1.目的

为形成公司统一的Java编码风格，以保障公司项目代码的易维护性和编码安全性，特制定本规范。

2.适用范围本标准适用于腾讯集团（含分公司等各级分支机构）所有使用Java作为开发语言的软件产品。 本标准中“腾讯集团”是指腾讯控股有限公司、其附属公司、及为会计而综合入账的公司，包括但不限于腾讯控股有限公司、深圳市腾讯计算机系统有限公司、腾讯科技（深圳）有限公司、腾讯科技（北京）有限公司、深圳市世纪凯旋科技有限公司、时代朝阳科技（深圳）有限公司、腾讯数码（深圳）有限公司、深圳市财付通科技有限公司。

3.总体原则

所有使用Java作为开发语言的软件产品都须遵照本规范的内容进行编码。

4.文件组织

4.1 规则 

4.1.1由于超过2000行的程序难以阅读，应该尽量避免出现超过2000行的程序；

4.1.2一个Java源文件都包含一个单一的公共类或接口。若私有类和接口与一个公共类

相关联，可以将它们和公共类放入同一个源文件。公共类必须是这个文件中的第一个类

或接口。

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实例变量：首先是公共级别的，随后是保护级别的，再后是包一级别的（没有访问

修饰符），最后是私有级别的；

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对齐只使用TAB键，不使用空格键； 

5.2.3不允许把多个短语句写在一行中，即一行只写一条语句；

5.2.4 if、for、do、while、case、switch、default等语句自占一行。

5.3 换行 

一行的长度超过80个字符需要换行，换行规则如下：

5.3.1在一个逗号后面断开；

5.3.2在一个操作符前面断开； 

5.3.3长表达式要在低优先级操作符处划分新行；

5.3.4新行缩进2个TAB。

5.4 间隔 

5.4.1类、方法及相对独立的程序块之间、变量说明之后必须加空行； 

5.4.2关键字之后要留空格， 象if、for、while  等关键字之后应留一个空格再跟左括号"（"， 以突出关键字； 

5.4.3方法名与其左括号"（"之间不要留空格, 以与关键字区别；  5.4.4

二元操作符如 " ="、" +="  " >="、" <="、" +"、*"、" %"、"&&"、" ||"、" <<" ," ^" 等的前后应当加空格； 

5.4.5一元操作符如" !"" ~"、"++"、" --"等前后不加空格；

5.4.6象"［ ］"、" ." 这类操作符前后不加空格；

5.4.7 for语句中的表达式应该被空格分开，如：   

5.4.8强制转型后应该跟一个空格，如： 

6.注释

原则： ——对已经不推荐使用的类和方法需要注明@Deprecated，并说明替代的类或者方法；  myMethod((byte) aNum, (Object) x)    for (expr1; expr2; expr3)  ——对于针对集合、开关的方法，要在方法注释中表明是否多线程安全。 

6.1 文件注释 

所有的源文件都应该在开头有一个注释，其中列出文件的版权声明、文件名、功能

描述以及创建、修改记录：     

6.2 类或接口注释 

采用JavaDoc文档注释，在类、接口定义之前应当对其进行注释，包括类、接口的描述、最新修改者、版本号、参考链接等：

注：

JavaDoc文档注释：描述Java的类、接口、构造方法、方法、以及字段。每个文档注释都被置于注释定界符/**...*/之中，一个注释对应一个类、接口或成员。该注释应位于声明之前。文档注释的第一行(/**)不需缩进，随后的文档注释每行都缩进1格(使星号纵向对齐

)。

6.3 字段注释 

采用JavaDoc文档注释，定义为

public的字段必需给出注释，在类的(静态)

变量、实例变量定义之前当对其进行注释，给出该字段的描述等：    

6.4 方法注释 

采用JavaDoc文档注释，在方法定义之前当对其进行注释，包括方法的描述、输入、

输出及返回值说明、抛出异常说明、参考链接等：   

6.5 其它注释(非文档注释) 

6.5.1单行代码注释一律使用注释界定符

7.命名

7.1 基本规则 

7.1.1使用可以准确说明变量、字段、类、接口、包等完整的英文描述符；

7.1.2采用大小写混合，提高名字的可读性； 

7.1.3采用该领域的术语；尽量少用缩写，但如果一定要使用，当使用公共缩写和习惯缩

写等； 

7.1.4避免使用相似或者仅在大小写上有区别的名字。

7.2 包命名 

7.2.1包名一律小写, 少用缩写和长名；

7.2.2采用以下规则：     [基本包].[项目名].[模块名子模块名]... 

7.2.3基本包：com.tencent或 com.qq 

7.2.4不得将类直接定义在基本包下，所有项目中的类、接口等都应当定义在各自的项目

和模块包中； 

7.3 类或接口命名 

类或接口名是个一名词，采用大小写混合的方式，每个单词的首字母大写。尽量使

你的类名简洁而富于描述。使用完整单词，避免用缩写词(除非该缩写词被更广泛使用，像

7.4 变量命名 

7.4.1采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写；

7.4.2变量名不应以下划线或美元符号开头； 

7.4.3尽量避免单个字符的变量名，除非是一次性的临时变量。临时变量通常被取名为i，j，

不采用匈牙利命名法则，

对不易清楚识别出该变量类型的变量应使用类型名或类型

名缩写作其后缀，

7.4.5组件或部件变量使用其类型名或类型名缩写作其后缀

7.4.6集合类型变量，例如数组和矢量，应采用复数命名或使用表示该集合的名词做后缀： 

7.5 常量命名  全部采用大写，单词间用下划线隔开：   

7.6 方法命名  方法名是一个动词，采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写；取值类可使用get前缀，设值类可使用set前缀，判断类可使用is(has)

前缀。

8.声明

8.1类或接口声明  类、接口定义语法规范： 

8.2方法声明 

8.2.1良好的程序设计应该尽可能减小类与类之间耦合，所遵循的经验法则是：尽量限制

成员函数的可见性。如果成员函数没必要公有 (public)，就定义为保护 (protected)；没

必要保护 (protected)，就定义为私有 (private)；

8.2.2方法定义语法规范：    [可见性]['abstract'] [‘static’] ['final']['synchronized'][返回值类型] 

method_name(参数列表)[('throws')][异常列表]  

8.2.3声明顺序：构造方法静态公共方法静态私有方法 公共方法 友元方法 受保护方法 私有方法main方法 

8.2.4方法参数建议顺序：(被操作者，操作内容，操作标志，其他)：GL/YF013-2007V1.0-L1   

11（建议性）

8.3变量声明

8.3.1一行一个声明； 

8.3.2声明局部变量的同时初始化（在变量的初始值依赖于某些先前发生的计算的特殊情况下可以不用同时初始化）；  

8.3.3只在代码块的开始处声明变量，（一个块是指任何被包含在大括号"{"和"}"中间的

代码）不要在首次用到该变量时才声明； 

8.3.4避免声明的局部变量覆盖上一级声明的变量，即不要在内部代码块中声明相同的变

量名； 

8.3.5公共和保护的可见性应当尽量避免，所有的字段都建议置为私有，由获取和设置成

员函数（Getter、Setter）访问； 

8.3.6定义一个变量或者常量的时候，不要包含包名（类似java.security.MessageDigest

digest =null），而要定义成下面的格式，除非是两个包有相同的类名：     

8.3.7字段定义语法规范：  数组声明时应当将"[]"跟在类型后，而不是字段名后：

GL/YF013-2007V1.0-L1   11    （建议性 ）

8.3.8数组声明时应当将"[]"跟在类型后，而不是字段名后：  

8.3.9声明顺序：  常量 类变量 实例变量： 公有字段  受保护字段 友元字段 私有字段   

9.异常

9.1捕捉异常的目的是为了处理它。 

9.2多个异常应分别捕捉并处理，避免使用一个单一的catch来处理。

10 习惯 

10.1 if、for、do、while等语句的执行语句部分无论多少都要加括号"{}"； 

10.2每当一个case顺着往下执行时(因为没有break语句)，通常应在break

语句的位置添加注释； 

10.3尽量避免在循环中构造和释放对象； 

10.4在使用局部变量的过程，按就近原则处理。不允许定义一个局部变量，然后在很远的地方才使用；

10.5相同的功能不允许复制成N份代码；

10.6在处理 String 的时候要尽量使用 StringBuffer 类。