文档介绍：tencent-java-编码规范
D
GL/YF 013--L1
17
GL/YF 013--L1
GL/YF 013--L1
17
GL/YF 013--L1
JAVA编码规范
1 目的
为形成公司统一的Java编码风格，以保障公司项目代码的易维护性和编码安全性，特制定本规范。
2 适用范围
本标准适用于腾讯集团（含分公司等各级分支机构）所有使用Java作为开发语言的软件产品。
本标准中“腾讯集团”是指腾讯控股有限公司、其附属公司、及为会计而综合入账的公司，包括但不限于腾讯控股有限公司、深圳市腾讯计算机系统有限公司、腾讯科技（深圳）有限公司、腾讯科技（北京）有限公司、深圳市世纪凯旋科技有限公司、时代朝阳科技（深圳）有限公司、腾讯数码（深圳）有限公司、深圳市财付通科技有限公司。
3 总体原则
所有使用Java作为开发语言的软件产品都须遵照本规范的内容进行编码。
4 文件组织
规则
，应该尽量避免出现超过2000行的程序；
。若私有类和接口与一个公共类相关联，可以将它们和公共类放入同一个源文件。公共类必须是这个文件中的第一个类或接口。
组织顺序
GL/YF 013--L1
17
GL/YF 013--L1
（参见""）；
：在多数Java源文件中，第一个非注释行是包语句。在它之后可以跟引入语句；
（参见""）；
；
：如果有关类或接口的信息不适合作为“类或接口文档注释”，可以在类或接口的实现注释中给出；
（静态）变量：首先是类的公共变量，随后是保护变量，再后是包一级别的变量（没有访问修饰符），最后是私有变量；
：首先是公共级别的，随后是保护级别的，再后是包一级别的（没有访问修饰符），最后是私有级别的；
；
：方法应该按功能分组，而不应该按作用域或访问权限进行分组。
范例
直接查看以下文件可以找到编码套用的规则：
（注：可以通过复制粘贴保存到硬盘）
5 代码风格
缩进
，缩进只使用TAB键，不能使用空格键（编辑器中请将TAB设置为4格）；
、类的定义、以及if、for、do、while、switch、case语句中的代码都要采用缩进方式；
对齐
"{" 和右大括号"}"都另起一行，应各独占一行并且位于同一列，同时与引用它们的语句左对齐；
，不使用空格键；
GL/YF 013--L1
6
GL/YF 013--L1
，即一行只写一条语句；
if、for、do、while、case、switch、default等语句自占一行。
换行
一行的长度超过80个字符需要换行，换行规则如下：
；
；
；
。
间隔
、方法及相对独立的程序块之间、变量说明之后必须加空行；
， 象if、for、while 等关键字之后应留一个空格再跟左括号"（"， 以突出关键字；
"（"之间不要留空格, 以与关键字区别；
" ="、" +=" " >="、" <="、" +"、" *"、" %"、" &&"、" ||"、" <<" ," ^" 等的前后应当加空格；
" !"、" ~"、" ++"、" --"等前后不加空格；
"［ ］"、" ." 这类操作符前后不加空格；
for语句中的表达式应该被空格分开，如：
for (expr1; expr2; expr3)
，如：
myMethod((byte) aNum, (Object) x)