Google编程标准规范专业资料

January20， 文献基本造式实践Javadoc档是GoogleJava编程风格规范完整定义。当且仅当一种Java源文献符也讨论某些商定及编码原则。然而，这份文档重要侧重于咱们所普遍遵循规则，对于那些不是明确强制规定，咱们尽量避免提供意见。2.3.1空白字符1术语阐明s2指南阐明2.1文献名，文献扩展名为.java。2.3特殊字符.3.2特殊转义序列 解。StringunitAbbrev="μs"；没有注释也非常清晰StringunitAbbrev="\u03bcs"；//"μs"没有理由要这样做|很糟，读者.一种顶级类(只有一种)3.1允许证或版权信息2不要换行顺序和间距n4.javaimportsvaximports3.4类声明3.4.1只有一种顶级类声明类成员顺序3.4.2.1重载：永不分离办法，这些函数/办法应当按顺序出当4.1大括号4.1.1使用大括号(虽然是可选)。对于非空块和块状构造，大括号遵循Kernighan和Ritchie风格(Egyptianckets•左大括号前不换行•左大括号后换行•右大括号前换行returnnewMyClass(){@Overridepublicvoidmethod(){if(condition()){try{}catch(ProblemExceptione){}}}4.1.3空块：可以用简洁版本ycatchfinallyvoiddoNothing(){}4.3一行一种语句4.5自动换行被分为多行，咱们称之为自动换行(line-wrapping)。对于同一段代码会有好几种有效自动换行方式。4.6.1垂直空白4.5.1从哪里断开(FooException|BarExceptione)格(语法元素存在多级4.6空白可选(既不勉励也不反对这样做(咱们也不勉励这样做)。4.6.2水平空白cho@SomeAnnotation({a，b})(不使用空格)。4.在任何二元或三元运算符两侧。这也合用于如下“类运算符”符号：o类型界限中&(<TextendsFoo&Bar>)。4.6.3水平对齐：不做规定用水平对齐代码，咱们也不需要去保持这种风格。privateintx；//thisisfineprivateColorcolor；//thistooedTip：对齐可增长代码可读性，但它为日后维护带来问题。考虑将来某个时候，你调节周边代码空白来使这一堆代码重新水平对齐(例如程序员4.7用小括号来限定组：推荐4.8详细构造4.8.1枚举类privateenumSuit{CLUBS，HEARTS，SPADES，DIAMONDS}4.8.2变量声明4.8.2.1每次只声明一种变量4.8.2.2需要时才声明，并尽快进行初始化4.8.3数组4.8.3.1数组初始化：可写成块状构造数组初始化可以写成块状构造，例如，下面写法都是OK：newint[]{，1，2，3}newint[]{3}newint[]{0，1,3}newint[]4.8.4.1缩进4.8.4.2Fall-through：注释switchinput{4.8.6.1块注释风格argeNumberinput}4.8.4.3default状况要写出来4.8.5注解(Annotations)和签名第一行出当前同一行。例如：@OverridepublicinthashCode(){...}应用于字段注解紧随文档块浮现，应用于字段各种注解容许与字段出当前同一@Partial@MockDataLoaderloader;规则。4.8.6注释*Thisis*okay.//Andso//isthis.ryoucanevendothis/Tip如果你但愿在必要时能重新换行(即注释像段落风格同*/。4.8.7Modifierspublicprotectedprivateabstractstaticfinaltransientvolatilesynchronizednativestrictfp5.1对所有标记符都通用规则5.2标记符类型规则.1包名.2类名HashIntegrationTest。2.3办法名2.4常量名intNUMBERscfinalSomeMutableTypeEMPTYARRAYenumSomeEnumENUM_CONSTANT}tslticnonstatictionnewHashSetStringmutableElementsggerMyClassgetNametringnonEmptyArraythesecanchange2.5非常量字段名6参数名局部变量名类型变量名5.3驼峰式命名法(CamelCase)式命名法(UpperCamelCase)和小驼峰式命名法formhmMuellersalgorithm格或其他标点符号(普通是连字符)处分割o每个单词第一种字母都大写，来得到大驼峰式命名。ProseformCorrectIncorrect------------------------------------------------------------------uestIdmporterImporteruestIDy6.1@Override：能用则用6.2捕获异常：不能忽视try{e}catch(NumberFormatExceptionok){umericthatsfinejustcontinue}例外：在测试中，如果一种捕获异常被命名为expected，则它可以被不加注释try{}catch(NoSuchElementExceptionexpected){}6.3静态成员：使用类进行调用FooaFoo=...;FooaStaticMethodgoodticMethodbadd6.4Finalizers：禁用c7.1格式通形式ultiplelinesofJavadoctextarewrittenhere*wrappednormally...publicintmethod(Stringp1){...}Anes