关闭

google代码风格

标签: 代码风格java
214人阅读 评论(0) 收藏 举报
分类:

源文件

  1. 缩进使用空格而不是制表符
  2. 类中的成员按照逻辑顺序排列,函数重载应放在一起,中间不要插入其他方法

格式

  1. 即使是可选的,也要使用大括号

  2. 左大括号前不换行
    左大括号后换行
    右大括号前换行
    如果右大括号是一个语句、函数体或类的终止,则右大括号后换行; 否则不换行。例如,如果右大括号后面是else或逗号,则不换行。
  3. 块缩进两个空格
  4. 一行一个语句,一行通常限制在80~100个字符
  5. 自动换行,非赋值运算符(如+)应在其前断开;赋值运算符(如=)应在其后断开;逗号应在前一行;自动换行时至少缩进4个空格;
  6. 空行,类内连续的成员之间;函数体内的逻辑分组;
  7. 空格,保留字与括号的外侧;在, : ;及右括号)后一条语句后的注释,双斜杠前后都要加空格
  8. 尽量使用小括号
  9. 变量声明,一次只声明一个变量;当需要使用变量时才声明,并且尽快初始化
  10. 注解,紧跟在文档块后,一个注解独占一行。
@Override
@Nullable
public String getNameIfPresent() { ... }

  1. 块注释风格
/*
 * This is          // And so           /* Or you can
 * okay.            // is this.          * even do this. */
 */

  1. 类和成员的modifiers的顺序:public protected private abstract static final transient volatile synchronized native strictfp

命名

  1. 包名,包名全部小写,连续的单词只是简单地连接起来,不使用下划线。
  2. 类名,驼峰命名法;类名通常是名词或名词短语,接口名称有时可能是形容词或形容词短语;测试类的命名以它要测试的类的名称开始,以Test结束。例如,HashTest或HashIntegrationTest
  3. 方法名,小驼峰命名法;方法名通常是动词或动词短语。
  4. 常量,全部字母大写,用下划线分隔单词
  5. 非常量字段,小驼峰命名法,通常是名词或名词短语
  6. 参数名,小驼峰命名法,避免用单个字符命名
  7. 局部变量,小驼峰命名法,局部变量可以使用宽松的缩写
  8. 类型变量名,可用以下两种风格之一进行命名:1. 单个的大写字母,后面可以跟一个数字(如:E, T, X, T2);2. 以类命名方式(5.2.2节),后面加个大写的T(如:RequestT, FooBarT)。

编程

  1. @Override:能用则用
  2. 异常,对捕获的异常应该进行响应,典型的做法是打印日志,如果确实不需要,用注释说明

javadoc

  1. 一般形式
/**
 * Multiple lines of Javadoc text are written here,
 * wrapped normally...
 */
public int method(String p1) { ... }
  1. Javadoc标记顺序:@param, @return, @throws, @deprecated
  2. 至少在每个public类及它的每个public和protected成员处使用Javadoc,如果一个注释是用来定义一个类,方法,字段的整体目的或行为, 那么这个注释应该写成Javadoc
0
0
查看评论

谷歌公司的C++编码风格

1. 头文件¶   通常每一个 .cc 文件都有一个对应的 .h 文件. 也有一些常见例外, 如单元测试代码和只包含 main() 函数的 .cc 文件.  正确使用头文件可令代码在可读性、文件大小和性能上大为改观.  下面的规则将引导你规避使用头文件...
  • Bro_J
  • Bro_J
  • 2017-03-15 18:10
  • 301

Java代码风格格式化和检查配置

1 说明 代码风格格式化和代码风格检查遵循Google代码风格。具体风格详见代码开发规范页。 2 code format eclipse-java-google-style.xml 模板(点击下载) 2.1 eclipse 设置->Java->CodeStyle-&g...
  • yangchangyong0
  • yangchangyong0
  • 2016-05-28 10:16
  • 1882

Eclipse中使用google代码风格

Eclipse中使用google代码风格
  • ZJDWHD
  • ZJDWHD
  • 2016-08-31 15:23
  • 949

Eclipse中使用google代码风格formatter

http://blog.csdn.net/lilu_leo/article/details/8746205 在Android项目中,特别是合作项目中,代码风格一致对于代码的编写特别重要,本文简单的讲一下如何在eclipse中导入google编码风格文件,关于更多内容,可以参考官网:http://s...
  • hotdust
  • hotdust
  • 2016-08-14 19:27
  • 6688

Google Java编程风格指南(献给那些没有良好编码习惯的程序员们)

作者:Hawstein出处:http://hawstein.com/posts/google-java-style.html声明:本文采用以下协议进行授权: 自由转载-非商用-非衍生-保持署名|Creative Commons BY-NC-ND 3.0 ,转载请注明作者及出处。目...
  • changemyself
  • changemyself
  • 2014-03-26 11:14
  • 8200

Google 编码风格之命名规范(备忘)

参考链接:http://zh-google-styleguide.readthedocs.io/en/latest/google-cpp-styleguide/naming/ 通用规则:所有函数、变量、类与文件命名尽量不要使用缩写,以方便理解。除了不容易引起歧义的,如DNS等。 特殊规则: ...
  • Firehotest
  • Firehotest
  • 2016-07-22 14:02
  • 3427

向google学习良好的C++代码风格-(1)概述

  • nanyu
  • nanyu
  • 2009-07-25 09:40
  • 2954

Google JavaScript代码风格指南

Google JavaScript代码风格指南 修正版本 2.28 原文:http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml Aaron Whyte Bob Jervis Dan Pupius Eric Ar...
  • mergerly
  • mergerly
  • 2015-07-06 10:52
  • 2217

R语言编码风格

来自 Google 的 R 语言编码风格指南 R 语言是一门主要用于统计计算和绘图的高级编程语言. 这份 R 语言编码风格指南旨在让我们的 R 代码更容易阅读、分享和检查. 以下规则系与 Google 的 R 用户群体协同设计而成. 表示和命名文件命名 文件名应以 .R (大写) 结尾, 文件名本...
  • zch19960629
  • zch19960629
  • 2017-04-27 16:33
  • 260

[editor]Source Insight定制之代码风格自动校准功能(AStyle的使用)

Source Insight定制之代码风格自动校准功能(AStyle的使用)
  • I_am_Tom
  • I_am_Tom
  • 2017-01-12 09:55
  • 2662
    个人资料
    • 访问:2174次
    • 积分:150
    • 等级:
    • 排名:千里之外
    • 原创:13篇
    • 转载:1篇
    • 译文:0篇
    • 评论:0条
    文章分类