这一篇文章为大家介绍 Kotlin 语言当前的编码风格。
编码风格
命名风格
如果有疑问,默认为 Java 编码风格,例如:
使用 CamelCase 命名方式(避免命名中含有下划线)
类型名称首字母用大写
方法和属性名称首字母用小写
缩进用 4 个空格
public 方法应该写文档,这样它就可以出现在 Kotllin Doc 中
冒号
在冒号区分类型和父类型中要有空格,在实例和类型之间没有空格:
interface Foo<out T : Any> : Bar { fun foo(a: Int): T }
Lambdas
在 Lambdas 表达式中,大括号与表达式间要有空格,箭头与参数和函数体间要有空格。尽可能的把 lambda 放在括号外面传入:
list.filter { it > 10 }.map { element -> element * 2 }
在使用简短而非嵌套的 lambda 中,建议使用 it 而不是显式地声明参数。在使用参数的嵌套 lambda中,参数应该总是显式声明:
类声明格式
参数比较少的类可以用简单的一行表示:
class Person(id: Int, name: String)
具有较多的参数的类应该格式化,这样每个构造函数的参数都位于缩进的单独行中。此外,结束括号应该在新行上。如果我们使用继承,那么超类构造函数调用或实现的接口列表应该位于与括号相同的行中:
class Person( id: Int, name: String, surname: String ) : Human(id, name) { // ... }
对于多个接口,应该首先定位父类构造函数调用,且每个接口应该位于不同的行中:
class Person( id: Int, name: String, surname: String ) : Human(id, name), KotlinMaker { // ... }
构造函数参数可以使用常规缩进或连续缩进(双倍正常缩进)。
Unit
如果函数返回 Unit,那么返回类型可以省略:
fun foo() { // ": Unit" 在这里被省略了 }
函数 vs 属性
在某些情况下,没有参数的函数可以与只读属性互换。尽管语义是相似的,但是有一些风格上的约定在什么时候更偏向于另一个。
在下面的情况下,更偏向于属性而不是一个函数:
不需要抛出异常
复杂度为 O(1)
低消耗的计算(或首次运行结果会被缓存)
返回与调用相同的结果