Kotlin 代碼風(fēng)格約定

代碼約定

官方文檔

本文包含了 Kotlin 語言當(dāng)前的編碼風(fēng)格陷遮。

命名風(fēng)格

若有疑問疗韵,請默認(rèn)使用Java編碼約定瓣赂,例如:

  • 用駝峰命名法慧域,并避免在名稱中使用下劃線
  • 類型名以大寫字母開頭
  • 方法和屬性以小寫字母開頭
  • 用4個(gè)空格縮進(jìn)
  • 公共方法應(yīng)該配有說明文檔

冒號

當(dāng)冒號分隔了類型和超類型時(shí)冒號之前有一個(gè)空格鲤竹;當(dāng)冒號分隔實(shí)例和類型時(shí)冒號之前沒有空格,:

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

Lambdas

在 lambda 表達(dá)式中昔榴,應(yīng)該在大括號周圍以及分割參數(shù)的箭頭周圍使用空格辛藻。只要有可能,一個(gè)lambda應(yīng)該倍傳遞到括號之外互订。

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

在簡短并且不嵌套的lambdas中吱肌,建議使用 it約定 而不是明確聲明參數(shù);
在具有參數(shù)的嵌套lambdas中仰禽, 參數(shù)應(yīng)始終明確聲明氮墨。

類頭部格式化

有較少幾個(gè)參數(shù)的類可以寫成一行

class Person(id: Int, name: String)

具有較長頭部的類應(yīng)該格式化,使得每個(gè)主構(gòu)造參數(shù)在有同樣縮進(jìn)的單獨(dú)的行中吐葵。
此外规揪,右括號應(yīng)該在新的一行。如果使用繼承温峭,那么父類構(gòu)造函數(shù)的調(diào)用或接口列表應(yīng)該和右括號在同一行猛铅。

class Person(
    id: Int,
    name: String,
    surname: String
) : Human(id, name) {
    // ...
}

對于多個(gè)接口,父類構(gòu)造函數(shù)應(yīng)該放在第一個(gè)凤藏,并且每一個(gè)接口應(yīng)該單獨(dú)寫在一行奸忽。

class Person(
    id: Int,
    name: String,
    surname: String
) : Human(id, name),
    KotlinMaker {
        //...
}

構(gòu)造函數(shù)的參數(shù)可以使用常規(guī)縮進(jìn)或連續(xù)縮進(jìn)(雙倍的常規(guī)縮進(jìn))。

單元 Unit

如果一個(gè)函數(shù)返回 Unit清笨, 返回值類型可以省略不寫:

fun foo() { // ": Unit" 被省略了

}

函數(shù) VS 屬性

在某些情況下月杉,沒有參數(shù)的函數(shù)可能 可以和 只讀屬性 互換。
雖然語義是相似的抠艾,但是有一些風(fēng)格約定是傾向于其中一個(gè)的苛萎。

在基礎(chǔ)算法中,傾向于屬性而非方法:

  • 不拋出錯(cuò)誤
  • 有一個(gè) O(1) 的復(fù)雜度
  • 易于計(jì)算
  • 返回結(jié)果與調(diào)用結(jié)果相同
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末检号,一起剝皮案震驚了整個(gè)濱河市腌歉,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌齐苛,老刑警劉巖翘盖,帶你破解...
    沈念sama閱讀 219,039評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異凹蜂,居然都是意外死亡馍驯,警方通過查閱死者的電腦和手機(jī)阁危,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,426評論 3 395
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來汰瘫,“玉大人狂打,你說我怎么就攤上這事』烀郑” “怎么了趴乡?”我有些...
    開封第一講書人閱讀 165,417評論 0 356
  • 文/不壞的土叔 我叫張陵,是天一觀的道長蝗拿。 經(jīng)常有香客問我晾捏,道長,這世上最難降的妖魔是什么哀托? 我笑而不...
    開封第一講書人閱讀 58,868評論 1 295
  • 正文 為了忘掉前任惦辛,我火速辦了婚禮,結(jié)果婚禮上萤捆,老公的妹妹穿的比我還像新娘裙品。我一直安慰自己俗批,他們只是感情好俗或,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,892評論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著岁忘,像睡著了一般辛慰。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上干像,一...
    開封第一講書人閱讀 51,692評論 1 305
  • 那天帅腌,我揣著相機(jī)與錄音,去河邊找鬼麻汰。 笑死速客,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的五鲫。 我是一名探鬼主播溺职,決...
    沈念sama閱讀 40,416評論 3 419
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼位喂!你這毒婦竟也來了浪耘?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,326評論 0 276
  • 序言:老撾萬榮一對情侶失蹤塑崖,失蹤者是張志新(化名)和其女友劉穎七冲,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體规婆,經(jīng)...
    沈念sama閱讀 45,782評論 1 316
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡澜躺,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,957評論 3 337
  • 正文 我和宋清朗相戀三年蝉稳,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片掘鄙。...
    茶點(diǎn)故事閱讀 40,102評論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡颠区,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出通铲,到底是詐尸還是另有隱情毕莱,我是刑警寧澤,帶...
    沈念sama閱讀 35,790評論 5 346
  • 正文 年R本政府宣布颅夺,位于F島的核電站朋截,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏吧黄。R本人自食惡果不足惜部服,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,442評論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望拗慨。 院中可真熱鬧廓八,春花似錦、人聲如沸赵抢。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,996評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽烦却。三九已至宠叼,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間其爵,已是汗流浹背冒冬。 一陣腳步聲響...
    開封第一講書人閱讀 33,113評論 1 272
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留摩渺,地道東北人简烤。 一個(gè)月前我還...
    沈念sama閱讀 48,332評論 3 373
  • 正文 我出身青樓,卻偏偏與公主長得像摇幻,于是被迫代替她去往敵國和親横侦。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,044評論 2 355

推薦閱讀更多精彩內(nèi)容

  • Python是一種對代碼風(fēng)格很重視的語言囚企,從縮進(jìn)就能看出這一點(diǎn)丈咐,Python強(qiáng)調(diào)易于理解。最近在負(fù)責(zé)代碼重構(gòu)的工作...
    知曰閱讀 10,887評論 1 85
  • Hello Word 在屏幕上打印“Hello, world”龙宏,可以用一行代碼實(shí)現(xiàn): 你不需要為了輸入輸出或者字符...
    restkuan閱讀 3,181評論 0 6
  • iOS編程規(guī)范0規(guī)范 0.1前言 為??高產(chǎn)品代碼質(zhì)量,指導(dǎo)廣大軟件開發(fā)人員編寫出簡潔棵逊、可維護(hù)、可靠银酗、可 測試辆影、高效...
    iOS行者閱讀 4,459評論 21 35
  • 1.0-基礎(chǔ)部分 pragma mark:輸出常量和變量 你可以用print(_:separator:termin...
    037e3257fa3b閱讀 909評論 2 7
  • 靜靜的池水徒像,青青的翠竹,蔽日的大樹蛙讥,曲曲折折的小路上锯蛀,很是清幽——這是香山上通往白園的路。路旁是古色古香的香山茶社...
    花香一縷閱讀 158評論 0 0