kotlin 官方学习教程之编码风格

爱被打了一巴掌 2022-06-15 01:23 254阅读 0赞

本页包含了当前 kotlin 语言的代码风格。

### 命名风格 ###

如有疑惑，默认为 Java 编码风格，比如：

*  使用 camelCase 命名法(在命名中避免下划线)
 *  类型名称首字母用大写
 *  方法和属性名称首字母用小写
 *  缩进用四个空格
 *  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)复杂度
 *  低消耗的计算(或首次运行结果会被缓存)
 *  返回与调用相同的结果

发表评论取消回复

表情：

评论列表（有 0 条评论，254人围观）

还没有评论，来说两句吧...

相关阅读

相关 Kotlin 官方学习教程之属性和字段

属性声明在 Kotlin 中类可以有属性，我们可以通过 var 关键字来声明可变属性，通过 val 关键字来声明只读属性。 class Address {

╰+攻爆jí腚メ/ 2022年06月15日 12:37/ 0 赞/ 254 阅读

相关 Kotlin 官方学习教程之接口

接口 Kotlin 中的接口和 Java 8 中的接口很像。他们可以包含抽象方法的说明和方法的实现。使接口和抽象类不同的是接口不能储存状态。接口可以含有参数，但必须是抽象

女爷i/ 2022年06月15日 12:18/ 0 赞/ 246 阅读

相关 Kotlin 官方学习教程之控制流

If 表达式在 Kotlin 中，if 是表达式，比如它可以返回一个值。因此，Kotlin 没有三元运算符 (condition ? then : else)，因为 i

小灰灰/ 2022年06月15日 04:52/ 0 赞/ 227 阅读

相关 kotlin 官方学习教程之包

一个源文件以包声明开始： package foo.bar fun baz() {} class Goo {} /

系统管理员/ 2022年06月15日 03:39/ 0 赞/ 259 阅读

相关 kotlin 官方学习教程之编码风格

本页包含了当前 kotlin 语言的代码风格。命名风格如有疑惑，默认为 Java 编码风格，比如：使用 camelCase 命名法(在命名中避免下划线)

爱被打了一巴掌/ 2022年06月15日 01:23/ 0 赞/ 255 阅读

相关 kotlin 官方学习教程之基本类型

在 Kotlin 中，所有变量的成员方法和属性都是对象。一些类型是内建的，它们的实现是优化过的，但对用户来说它们就像普通的类一样。在这节中，我们将会讲到大多数的类型：数值，字符

╰+攻爆jí腚メ/ 2022年06月15日 00:39/ 0 赞/ 254 阅读

相关 kotlin 官方学习教程之语法

这是 kotlin 学习教程第二篇，为大家讲解 kotlin 的语法。因为本系列文章是作者翻译官方文档而来，所以有一些描述可能不太正确，建议大家都到官网运行一下实例，有助于理解

秒速五厘米/ 2022年06月15日 00:17/ 0 赞/ 304 阅读

相关 kotlin 官方学习教程之基础语法

Google 在今天的举行了 I/O 大会，大会主要主要展示内有容 Android O（Android 8.0）系统、Google Assistant 语音助手、Google

深藏阁楼爱情的钟/ 2022年06月14日 23:52/ 0 赞/ 271 阅读

相关 Kotlin 官方学习教程之扩展

扩展类似于 C\ 和 Gosu， Kotlin 也提供了一种可以在不继承父类也不使用类似装饰器这样的设计模式的情况下对指定类进行扩展的功能。这是通过称为扩展名的特殊声明

ゝ一纸荒年。/ 2022年06月14日 00:25/ 0 赞/ 282 阅读

相关 Kotlin 官方学习教程之可见性修饰符

可见性修饰符类，对象，接口，构造函数，属性以及它们的 setter 方法都可以有可见性修饰词。( getter 总是具有与该属性相同的可见性。)。在 Kotlin 中有

客官°小女子只卖身不卖艺/ 2022年06月13日 23:39/ 0 赞/ 288 阅读