Kotlin编码约定/编码风格 - Kotlin教程™

在本篇文章中,主要是介绍Kotlin语言的当前编码风格。

命名风格

如果有疑问,请使用Java编码约定,例如:

冒号

冒号之前有一个空格,冒号分隔了类型和超类型,并且没有空格,冒号分隔实例和类型:

interface Foo<out T : Any> : Bar {
    fun foo(a: Int): T
}

Lambda表达式

在lambda表达式中,大括号周围应该使用空格,以及将参数与主体使用箭头分开。 只要有可能,lambda应该传递到括号之外。

list.filter { it > 10 }.map { element -> element * 2 }

在短而且不嵌套的lambdas中,建议使用它的惯例,而不是明确声明参数。 在具有参数的嵌套lambdas中,参数应始终要明确声明。

类头格式化

有几个参数的类可以写成一行:

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" is omitted here

}

函数和属性

在某些情况下,没有参数的函数与只读属性可互换。虽然语义是相似的,但是有一些风格约定的时候可适当选择使用。

当用在基础算法时,属性优先于函数情况:


本站所有代码下载:请扫描本页面底部(右侧)二维码并关注微信公众号,回复:"代码下载" 获取。

上一篇:Kotlin惯用语法下一篇:Kotlin数据类型