前言

在 Java 中，有個(gè)叫 SuppressWarnings 的注解，用于忽略特定的編譯器警告。Kotlin 中也有一個(gè)類似功能的注解，叫做 Suppress，本文主要講講這個(gè)注解有什么用。

常規(guī)用法

有時(shí)候會(huì)寫出這樣的一些代碼。這些在Kotlin編譯器的眼里可能出現(xiàn)問題的代碼，實(shí)際上卻非常正確，跑起來不會(huì)出任何問題。

然后你就得到了一個(gè)編譯器警告（warning），甚至是編譯錯(cuò)誤（error）。

比較常見的，比如說 unchecked cast：

val some: List<*> = emptyList<Nothing>()
some as List<String> // Unchecked cast: List<*> to List<String>

然后就可以使用 Suppress 取消這個(gè) warning：

val some: List<*> = emptyList<Nothing>()
@Suppress("UNCHECKED_CAST")
some as List<String>

再舉個(gè)例子：

sealed class Base {
 @Suppress("LeakingThis")
 val code = calculate()
 abstract fun calculate(): Int

 class Derived : Base() {
  override fun calculate() = 42
 }
}

上面這代碼并不會(huì)出現(xiàn) warning 的具體說明里的問題，所以使用了 Suppress 解決這個(gè) warning。

這是很簡單的破事水，沒有任何討論的價(jià)值。

然后下面是正文。

好孩子不要模仿！很危險(xiǎn)的！

非常規(guī)用法

這破注釋竟然能消除 error！

比如說這樣的代碼：

println((null as String?).length)

編譯器會(huì)告訴你這樣是不對(duì)的，然后向你丟出了一個(gè) error：

Only safe (?.) or non-null asserted (!!.) calls are allowed on a nullable receiver of type String?

然后就可以使用 Suppress 讓編譯器閉嘴！

@Suppress("UNSAFE_CALL")
println((null as String?).length)

然后就可以順利的通過編譯，編譯后跑一跑，就可以輕松地拿到一個(gè)空指針異常：

Exception in thread "main" java.lang.NullPointerException
    at .......

很簡單，有了 Suppress，你就可以讓這些可以本來通過編譯器生成java字節(jié)碼，但是因?yàn)楦鞣N各樣的原因（例如類型安全）被ban掉的代碼，順利通過編譯。

下面給幾個(gè)可能有用的例子。

例1

fun some(any: Any) {
 when(any) {
  is Array<String> -> println(any.size)
 }
}

這是我吐槽過的「Java能做但是Kotlin做不了的事」系列之一。不考慮Kotlin的其他target（如js），在Jvm平臺(tái)上有如下的迂回：

any is Array<*> && any.isArrayOf<String>()

就是很丑罷了。

在Kotlin的早期代碼，這樣的type check是允許的，因?yàn)槟承┰騜an掉了（讀者可以想想為什么要ban掉這樣的代碼）。這個(gè)時(shí)候可以用 Suppress 把這個(gè)后門打開。

@Suppress("CANNOT_CHECK_FOR_ERASED")

例2

類型別名。

class Some {
 @Suppress("TOPLEVEL_TYPEALIASES_ONLY")
 typealias Str = String

 val a: Str = ""
}

一目了然，不解釋。

例3

Kotlin 在遠(yuǎn)古版本 M13 新增了 lateinit 修飾符，可以對(duì)只讀屬性和可變屬性使用。

然后 M14 版本就殘忍地 ban 掉了 lateinit val。

@Suppress("INAPPLICABLE_LATEINIT_MODIFIER")
lateinit val lateInitVal: String

lateinit val 的用處可以看上面 M13 的鏈接里面的說明。

例4

Kotlin Collection Literals 半成品。

@Suppress("UNSUPPORTED")
val bs: BooleanArray = [true, false, true]

這是個(gè)未完成的功能，目前只支持?jǐn)?shù)組。以后可以支持 List、Map 和 Set，所以為了避免不必要的兼容性麻煩，在正常情況下只允許在注解里這樣用。要想在其他地方用，就像上面代碼那樣。

結(jié)尾

想知道更多的Suppress選項(xiàng)的話，可以去翻Kotlin的源碼。

這種無法得到官方支持的奇技淫巧，也許下次更新就掛掉了，所以如果用了那就后果自負(fù)吧。

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，如果有疑問大家可以留言交流，謝謝大家對(duì)腳本之家的支持。