「Java 編譯錯誤/警告」喜好設定

請在 開啟「錯誤/警告」喜好設定頁面 Java > 編譯器 > 錯誤/警告喜好設定頁面中,指出「錯誤/警告」設定的喜好設定。

程式碼樣式

選項

說明

預設值

static 成員的非 Static 存取

當啟用這個選項時,每當以表示式接收器存取 static 欄位或方法時,編譯器將發出錯誤或警告。 應該以類型名稱限定 static 成員的參照。

警告

static 成員的間接存取

如果啟用,編譯器會在間接存取 static 欄位或方法時,發出錯誤或警告。介面的 static 欄位應該以宣告類型名稱定義。

忽略

實例欄位的不完整存取

如果啟用,編譯器會在發現不完整的欄位存取(例如:遺漏 'this')時,發出錯誤或警告。

忽略

存取含括類型中無法存取的成員

當啟用時,只要其模擬存取含括類型中無法存取的成員,編譯器即會發出錯誤或警告。這類存取可能涉及效能。

忽略

參數指派

指派參數值通常都被視為不好的程式設計風格。 如果啟用這個選項,編譯器會發出訊號,指出這類情況為錯誤或警告。

忽略

未提出的字串

當啟用時,編譯器會針對未提出的 String 文字(也就是不含 //$NON-NLS-<n>$ 標籤)或不屬於 String 的未提出之 String 標籤,發出一則錯誤或警告。

忽略

未記載的空區塊

如果啟用,編譯器會在發現不含解說註解的空區塊陳述式時,發出錯誤或警告。

忽略

未透過 try-with-resource 來管理資源(1.7 或更新版本)

如果啟用,則如果區域變數保留類型 'java.lang.AutoCloseable' 的值,且如果明確在該資源上呼叫方法 'close()',但未以 try-with-resources 區塊管理該資源,編譯器會發出錯誤或警告。

忽略

含建構子名稱的方法

如果以建構子名稱來命名方法,通常會被視為較差的程式設計風格。 如果啟用這個選項,編譯器會發出訊號,指出這類情況為錯誤或警告。

警告

方法可以是 static

當啟用時,如果方法是 private 或 final,並且僅參照 static 成員,則編譯器會發出錯誤或警告。

忽略

方法可能是 static

當啟用時,如果方法不是 private 或 final,並且僅參照 static 成員,則編譯器會發出錯誤或警告。請注意,由於可以置換子類別中的方法,如果您讓「可能是 static」的方法變成 static,這可能會中斷現有的用戶端。

忽略

可能的程式設計問題

比較相同的值 ('x == x')

如果啟用,編譯器會在比較作業涉及相同的運算元(如 'x == x')時,發出錯誤或警告。

警告

指派無效(如 'x = x')

當啟用這個選項時,每當指派沒有效果(如 'x = x')時,編譯器將發出錯誤或警告。

警告

可能的 Boolean 意外指派(如 'if (a = b)')

如果啟用,編譯器會在發現可能的 Boolean 意外指派(如 'if (a = b)')時,發出錯誤或警告。

忽略

包覆和未包覆的轉換

如果啟用,編譯器會在發現 boxing 或 unboxing 轉換時,發出錯誤或警告。autoboxing 對效能可能會有負面影響。

忽略

在字串連結中使用字元陣列

當啟用時,每當在下列「字串」連結中使用 char[] 表示式時,編譯器就會發出錯誤或警告:

"hello" + new char[]{'w','o','r','l','d'}

警告

vararg 引數不嚴格的類型比對

如果啟用,編譯器會在發現 vararg 引數不嚴格的類型比對時,發出錯誤或警告。

警告

空的陳述式

如果啟用,編譯器會在發現空的陳述式(例如:多餘的分號)時,發出錯誤或警告。

忽略

未用的物件配置

如果啟用,當編譯器發現未用的配置物件時,就會發出錯誤或警告,例如:

if (name == null)
   new IllegalArgumentException();

忽略

列舉的 'switch' case 不完整

如果啟用,編譯器會在發現 switch 陳述式不含參照列舉之每一個列舉常數的 case 陳述式也不含 default case 時,發出錯誤或警告。 Default case 假設為涵蓋每一個列舉常數的 case 陳述式,所以在有 default case 的情況下,編譯器沒有動作,除非啟用「即使「預設」案例存在也發出信號」選項(參見下文)。

警告

即使「預設」案例存在也發出信號

如果啟用,當 case 未涵蓋列舉常數時,即使 default case 存在,編譯器還是會另外發出錯誤或警告。當新增列舉常數時,這個選項對捕捉遺漏的 case 陳述式很有用。

關閉

'switch' 遺漏 'default' case

如果啟用,編譯器會在 'switch' 陳述式缺少 default case 時,發出錯誤或警告。因此,即使 'case' 陳述式涵蓋所有可能的值,仍會標示遺漏 'default'。 基於二進位相容性,Java 語言規格建議使用這個警告。

忽略

'switch' case 失敗

如果啟用,當因為前述的非空白案例失敗而進入某個案例時,編譯器會發出錯誤或警告。

忽略

隱藏 catch 區塊

對 try 陳述式的本端環境而言,某些 catch 區塊可能會隱藏其他區塊,例如:

try { throw new java.io.CharConversionException();
} catch (java.io.CharConversionException e) {
} catch (java.io.IOException e) {}

如果啟用,編譯器會針對隱藏的 catch 區塊(對應至所檢查之異常狀況),發出錯誤或警告。

警告

'finally' 未正常完成

如果啟用,編譯器會在 'finally' 陳述式未正常完成(例如:包含 return 陳述式)時,發出錯誤或警告。

警告

停用碼(例如 'if (false)')

如果啟用,當編譯器發現停用碼(例如 'if (false)')時,就會發出錯誤或警告。

警告

資源洩漏

如果啟用,則如果區域變數保留類型 'java.lang.AutoCloseable' 的值(標準 >= 1.7) 或類型 'java.io.Closeable' 的值(標準 <= 1.6),且如果流程分析指出未在區域範圍內在該值上呼叫方法 close(),編譯器會發出錯誤或警告。

警告

潛在資源洩漏

如果啟用,則如果區域變數保留類型 'java.lang.AutoCloseable' 的值(標準 >= 1.7) 或類型 'java.io.Closeable' 的值(標準 <= 1.6),且如果流程分析指出所有執行路徑未在區域範圍內在該值上呼叫方法 close(),編譯器會發出錯誤或警告。

忽略

不含 serialVersionUID 的可序列化類別

如果啟用,編譯器會在實作 'java.io.Serializable' 的類型不含 serialVersionUID 欄位時,發出錯誤或警告。

警告

繼承的方法中遺漏已同步的修飾元

如果啟用,一旦編譯器發現繼承的方法中遺漏已同步的修飾元時,就會發出錯誤或警告。

忽略

類別置換 'equals()' 而非 'hashCode()'

如果啟用,當編譯器發現類別置換 'equals()' 而非 'hashCode()' 時,就會發出錯誤或警告。

忽略

名稱投影和衝突

欄位宣告隱藏另一個欄位或變數

如果啟用,編譯器會在欄位宣告隱藏另一個繼承的欄位時,發出錯誤或警告。

忽略

區域變數宣告隱藏另一個欄位或變數

如果啟用,當區域變數宣告隱藏另一個欄位或變數時,編譯器會發出錯誤或警告。

忽略

包括建構子或 setter 方法參數

如果啟用,當建構子或 setter 方法參數隱藏另一個欄位或變數時,編譯器會另外發出錯誤或警告。

關閉

類型參數隱藏另一個類型

如果啟用,例如,當內部類別的類型參數隱藏外部類型時,編譯器會發出錯誤或警告。

警告

方法未置換套件可見方法

套件的預設方法在另一套件中看不到,因此無法置換。如果啟用這個選項,編譯器會發出訊號,指出這類情況為錯誤或警告。

警告

介面方法與受保護的 'Object' 方法衝突

當啟用時,每當介面定義一個與非繼承「物件」方法不相容的方法時,編譯器將發出錯誤或警告。在解決這個衝突之前,將無法實作這類介面,例如:

interface I {
   int clone();
}

警告

淘汰和受限制的 API

已淘汰的 API

當啟用這個選項時,編譯器將使用已淘汰的 API 標為錯誤或警告。

警告

通知使用已淘汰之程式碼內已淘汰的 API

一旦啟用,編譯器將發出信號,指出在已淘汰的程式碼內使用已淘汰的 API。問題的嚴重性是由「已淘汰的 API」選項來控制。

關閉

通知置換或實作已淘汰的方法

如果啟用,編譯器會通知置換或實作已淘汰的方法。問題的嚴重性是由「已淘汰的 API」選項來控制。

關閉

禁止的參照(存取規則)

如果啟用,編譯器會通知存取規則中指定了禁止的參照。

錯誤

不建議的參照(存取規則)

如果啟用,編譯器會通知存取規則中指定了不建議的參照。

警告

不必要的程式碼

不使用區域變數值

如果啟用,每當宣告了區域變數,但不曾在其範圍內使用它的值時,編譯器會發出錯誤或警告。

警告

未使用參數值

如果啟用,每當宣告了參數,但不曾在其範圍內使用它的值時,編譯器會發出錯誤或警告。

忽略

在置換和實作方法中忽略

如果啟用,每當宣告了參數,但不曾在置換或實作另一方法的方法範圍內使用該參數時,編譯器不會發出錯誤或警告。

開啟

忽略以 '@param' 標籤記載的參數

如果啟用,每當以 '@param' 標籤記載未讀取的參數時,編譯器不會發出錯誤或警告。

開啟

匯入未使用

當啟用時,編譯器會針對未用的匯入參照,發出錯誤或警告。

警告

未用的 private 成員

如果啟用,每當宣告了 private 成員,但不曾在相同單元內使用時,編譯器會發出錯誤或警告。

警告

不必要的 'else' 陳述式

如果啟用,編譯器會在發現不必要的 else 陳述式(如 if (condition) return; else doSomething();)時,發出錯誤或警告。

忽略

不必要的 cast 或 'instanceof' 作業

如果啟用,編譯器會在發現不必要的 cast 或 'instanceof' 作業(如 if (object instanceof Object) return;)時,發出錯誤或警告。

忽略

不必要的擲出異常狀況宣告

如果啟用,編譯器會在發現不必要的擲出異常狀況宣告時,發出錯誤或警告。

忽略

在置換和實作方法中忽略

如果啟用,每當編譯器在置換或實作另一方法的方法中發現不必要的擲出異常狀況宣告時,將不會發出錯誤或警告。

開啟

忽略 '@throws' 或 '@exception' 標籤所說明的異常狀況

如果啟用,每當以 '@throws' 或 '@exception' 標籤記載不必要的擲出異常狀況宣告時,編譯器不會發出錯誤或警告。

開啟

忽略 'Exception' 和 'Throwable'

如果啟用,每當編譯器發現不必要的 'Exception' 和 'Throwable' 異常狀況宣告時,將不會發出錯誤或警告。

開啟

未用的 'break' 或 'continue' 標籤

如果啟用,每當編譯器發現未用的 'break' 或 'continue' 標籤時,它都會發出錯誤或警告。

警告

冗餘超介面

如果啟用,當編譯器發現類型明確實作的介面已由其任何超類型實作時,將會發出錯誤或警告。

忽略

一般的類型

未檢查的一般的類型作業

如果啟用,編譯器會在發現未檢查的一般的類型作業時,發出錯誤或警告。

警告

使用原始類型

如果啟用,每當編譯器發現使用原始類型(例如:使用 List 而不是 List<String>)時,它都會發出錯誤或警告。

警告

以 final 類型界限宣告的一般的類型參數

如果啟用,編譯器會在發現用到 final 類型的類型界限時,發出錯誤或警告。

警告

忽略無法避免的一般類型問題

如果啟用,編譯器只要偵測到程式設計師無法避免的一般類型問題,它就會發出錯誤或警告。例如,強迫某類型使用其方法簽章中的原始類型,並且傳回類型,因為它從超類型置換的方法是宣告為在第一個位置使用原始類型。

一般化所參照的原始 API 之後,您不會看到任何問題(如果一般類型正確)或編譯錯誤(如果是以不同方式一般化 API)。

關閉

註釋

遺漏 '@Override' 註釋

如果啟用,編譯器會在發現方法置換了另一個實作的方法且遺漏 '@Override' 註釋時,發出錯誤或警告。

忽略

併入介面方法實作(1.6 或更新版本)

啟用之後,每當編譯器發現有方法置換或實作介面中所宣告的方法,而又遺漏 '@Override' 註釋,編譯器也會發出錯誤或警告。
請注意,只有當編譯器標準層次是 1.6 或更新的版本時,才允許在這類方法上使用 '@Override',因此,這個錯誤或警告絕不會出現在 1.5 程式碼中。

開啟

遺漏 '@Deprecated' 註釋

如果啟用,編譯器會在發現已淘汰的類型但沒有其他 '@Deprecated' 註釋時,發出錯誤或警告。

忽略

註釋用來作為超介面

如果啟用,編譯器會在發現類型實作了註釋時,發出錯誤或警告。雖然可用,但這是不佳的作法。

警告

'@SuppressWarnings' 中有未處理的記號

如果啟用,編譯器會在發現 '@SuppressWarnings' 註釋中有不明的記號時,發出錯誤或警告。

警告

啟用 '@SuppressWarnings' 註釋

如果啟用,編譯器會處理 '@SuppressWarnings' 註釋。 如果啟用,則處理方式如同移除所有 '@SuppressWarnings' 註釋。

開啟

未用的 '@SuppressWarnings' 記號

如果啟用,編譯器會在發現 '@SuppressWarnings' 註釋中有未用的記號時,發出錯誤或警告。

警告

使用 '@SuppressWarnings' 來暫停選用錯誤

如果啟用,'@SuppressWarnings' 註釋也會抑制選用的編譯錯誤,亦即這裡選項設為「錯誤」 。無法暫停必要的編譯錯誤。

關閉

空值分析

空值指標存取

如果啟用,編譯器會在發現解除參照的區域變數確實是空值時,發出錯誤或警告。 請注意,這項分析並無法找到所有空值指標存取,請參閱可能的空值指標存取。

警告

可能的空值指標存取

如果啟用,當編譯器發現解除參照可能是空值的區域變數時,它都會發出錯誤或警告。 請注意,這項分析非常保守,它只會考量有可疑情況的案例。

使用空值註釋可以改良分析的品質,可使用選項啟用註釋型空值分析來啟用這個功能

忽略

冗餘空值檢查

如果啟用,每當不得為空值的區域變數測試結果為空值時,編譯器會發出錯誤或警告。

忽略

在空值分析中,併入 'assert'

如果啟用,編譯器允許在執行空值分析時使用 'assert' 陳述式。

關閉

啟用註釋型空值分析

如果啟用,編譯器會將註釋 @Nullable、@NonNull 及 @NonNullByDefault,解譯成指定給定的類型是否包含 'null' 值。

這些分析的效果由下列子選項進一步控制。

另請參閱使用空值註釋。

關閉

空值規格的違規

視這個選項而定,編譯器會在偵測到下列其中一個狀況時,發出錯誤或警告:

  1. 以非空值註釋宣告的方法傳回可為空值表示式。
  2. 可為空值表示式當成引數傳入方法呼叫中,其中被呼叫方法的對應參數是以非空值註釋來宣告。
  3. 可為空值表示式指派給以非空值註釋所宣告的區域變數。
  4. 有一個方法置換以非空值註釋所宣告的繼承方法,嘗試指定可為空值的註釋來鬆綁該合約(禁止反變傳回)。
  5. 有一個方法置換至少一個參數是可為空值宣告的繼承方法,嘗試指定對應參數的非空值註釋來緊縮空值合約(禁止共變參數)。

在上方,如果確實知道表示式會評估為 null 值,或如果以可為空值註釋來宣告,則表示式視為可為空值。

錯誤

空值註釋與空值推斷之間發生衝突

視這個選項而定,編譯器會在偵測到下列其中一個狀況時,發出錯誤或警告:

  1. 以非空值註釋宣告的方法傳回表示式,確實已知該表示式在某些流程上評估為空值。
  2. 確實已知在某些流程上評估為空值的表示式,當作引數傳入方法呼叫中,其中被呼叫方法的對應參數是以非空值註釋來宣告。
  3. 確實已知在某些流程上評估為空值的表示式,指派給以非空值註釋宣告的區域變數。

錯誤

未檢查從非標註類型轉換成 @NonNull 類型

視這個選項而定,編譯器會在偵測到下列其中一個狀況時,發出錯誤或警告:

  1. 以非空值註釋宣告的方法傳回表示式,但可用的空值資訊不足,無法確實證明執行時期不會有流程傳遞空值。
  2. 無足夠空值資訊可確實證明決不會在執行時期評估為空值的表示式,當成引數傳入方法呼叫中,其中被呼叫方法的對應參數是以非空值註釋來宣告。
  3. 無足夠空值資訊可確實證明決不會在執行時期評估為空值的表示式,指派給以非空值註釋宣告的區域變數。

未檢查的轉換通常是因為使用其他未標註的變數或方法。

警告

多餘空值註釋

如果啟用,當套用非空值註釋時,編譯器會發出錯誤或警告(雖然依預設套用在現行位置上已達到相同效果)。 啟用選項使用非空值作為整個工作區(或整個專案)預設值或使用 @NonNullByDefault 註釋可設定這種預設值。

警告

套件遺漏 '@NonNullByDefault' 註釋

如果啟用,編譯器會在下列狀況發出錯誤或警告:

  1. 因為遺漏 package-info.java,或 package-info.java 中遺漏預設空值註釋,造成套件未包含預設空值註釋時。
  2. 當預設套件內的類型不含預設空值註釋時。

忽略

空值規格使用預設註釋

如果啟用,編譯器會使用空值規格的預設註釋集。這些註釋位於 Eclipse SDK 的 org.eclipse.jdt.annotation 軟體組中。

您可以指定在專案中使用不同的註釋名稱,但要注意 Eclipse 編譯器僅支援預設註釋中指定的語意:

  • org.eclipse.jdt.annotation.Nullable:Java 註釋類型的完整名稱,當套用至方法簽章或變數宣告中的類型時,將會解譯成一種規格,表示 null 在該位置中是合法值。
    目前支援的位置為:方法參數、方法傳回類型及區域變數。
  • org.eclipse.jdt.annotation.NonNull:Java 註釋類型的完整名稱,當套用至方法簽章或變數宣告中的類型時,將會解譯成一種規格,表示 null 在該位置中不是合法值。
    目前支援的位置為:方法參數、方法傳回類型及區域變數。
  • org.eclipse.jdt.annotation.NonNullByDefault:Java 註釋類型的完整名稱。套用至元素而未指定註釋引數時,標註元素內的方法簽章中的所有未標註類型,將視為使用非空值註釋來指定。
    相反地,當以常數 'false' 為引數來套用註釋時,則標註的元素會取消在外部範圍的所有對應的預設值。

開啟

當啟用將上述錯誤視為嚴重編譯錯誤時,所有產生的錯誤(嚴重錯誤或可配置的錯誤)都會導致不可執行的程式碼。 如果停用,則只要程式碼沒有嚴重錯誤(語法錯誤、類型錯誤,或 Java 語言規格認定的任何錯誤),都可以執行。

相關概念

「問題」視圖
快速修正程式
Java 建置器