要訣和技巧 (JDT)

下列要訣和技巧提供了許多有用的建議,您可以使用它們來增加您的生產力。另請參閱平台要訣和技巧以取得一般 Eclipse 要訣;以及參閱 3.6 版新增功能 (JDT) 以取得這個版本的特性。


編輯   |   重構   |   搜尋   |   導覽   |   視圖   |   細項   |   除錯


編輯程式碼

內容輔助 內容輔助會提供您一個清單,其中列出已有部分輸入之字串的建議完成的清單。在 Java 編輯器中,按下 Alt+/,或使用編輯 > 內容輔助。

「選取內容輔助」對話框

Javadoc 註解中的內容輔助 Javadoc 註解中也有可用的內容輔助。

Javadoc 註解的內容輔助

靜態匯入項目的內容輔助 如果要取得 static 成員的相關內容輔助提議,請在 開啟「我的最愛」喜好設定頁面 Java > 編輯器 > 內容輔助 > 我的最愛喜好設定頁面中,配置一份我的最愛 static 成員清單。

例如,如果您已在這份清單中新增 java.util.Arrays.*,就會將這種類型中符合完成字首的所有 static 成員,新增至提議清單中:

內容輔助提議

暫停內容輔助中的類型 如果不要讓某些類型出現在內容輔助中,請使用在 開啟類型過濾器喜好設定頁面 Java > 外觀 > 類型過濾器喜好設定頁面中配置的類型過濾器特性。 類型只要符合其中一個過濾器型樣,就不會出現在「開啟類型」對話框中,內容輔助、快速修正程式和組織匯入也都無法使用它。 這些過濾器型樣不會影響「套件瀏覽器」和「類型階層」視圖。

類型過濾器喜好設定頁面

完成變數、方法參數和欄位名稱的內容輔助 您可以使用內容輔助加速欄位、方法參數和區域變數的建立。 請把游標放在宣告的類型名稱後面,並按下 Alt+/,或使用編輯 > 內容輔助。

建議的欄位名稱

如果欄位、區域變數或方法參數使用名稱字首或字尾,請務必在 開啟程式碼樣式喜好設定頁面 Java > 程式碼樣式喜好設定頁面中加以指定。

其類型無法解析之變數的內容輔助 當存取尚未匯入的類型時,程式碼輔助也能夠發揮功效。視 開啟「內容輔助」喜好設定頁面 Java > 編輯器 > 內容輔助 > 新增匯入項目而非完整名稱喜好設定而定,編輯器會自動新增匯入項目,或是完整定義這類提議的類型。

當在下列情況按下 ; 時:

此擷取畫面顯示其類型無法解析之變數的內容輔助

產生:

此擷取畫面顯示按下 ';' 時的內容輔助結果

instanceof 條件之後的內容輔助 內容輔助可以針對 instanceof 條件中使用的類型,提議可用的成員。

此擷取畫面顯示 instanceof 條件之後的內容輔助

在您選取這類的提議時,Eclipse 會為您新增必要的強制轉型。

參數提示 當游標位在方法引數時, 您可以看到參數提示的清單。在「Java 編輯器」中,按下 Ctrl+Shift+空格鍵,或呼叫編輯 > 內容輔助 > 參數提示。

參數提示浮動說明

匿名類別上的內容輔助 當建立匿名類別時,內容輔助也會提供說明。 將游標置於 "new " 之後和抽象類別或介面名稱開頭, 按 Alt+/ 或呼叫編輯 > 內容輔助 > 預設值。

匿名類別的內容輔助

這將建立匿名內部類別的主體,其中包括所有需要實作的方法。

如果您將脫字符號 (^) 放在建立類別實例的左括弧之後,也可以運作:

匿名類別的內容輔助

在插入和置換內容輔助之間切換 當在現有的 ID 呼叫內容輔助時,它可以將這個 ID 換成您所選擇的完成作業,或執行插入動作。 預設行為(改寫或插入)定義在 開啟內容輔助喜好設定頁面 Java > 編輯器 > 內容輔助喜好設定頁面中。
您可以在按住 Ctrl 鍵並選取「完成」,於「選取內容輔助」對話框內暫時切換行為。
增量內容輔助 類似於 UNIX Shell 展開,內容輔助也可以自動插入共用字首。如果要啟用該行為,請在 開啟內容輔助喜好設定頁面 Java > 編輯器 > 內容輔助喜好設定頁面中,選取勾選框。
完成程式碼中的駝峰式大小寫支援 完成程式碼支援駝峰式大小寫型樣。例如在完成 NPE 或 NuPoiE 時,將提議 NullPointerException。您可以在 開啟「內容輔助」喜好設定頁面 Java > 編輯器 > 內容輔助喜好設定頁面中,利用顯示駝峰式大小寫相符喜好設定來停用這項支援。

完成 NPE 的 Java 編輯器

自訂內容輔助種類 重複呼叫內容輔助 (Alt+/) 會歷經不同的提議種類。

含有新方法範本提議的內容輔助

如果要配置顯示的種類,請使用 開啟內容輔助喜好設定頁面 Java > 編輯器 > 內容輔助 > 進階喜好設定頁面。

另外,您也可以將個別的按鍵捷徑指派給我的最愛提議種類。

建立 getter 和 setter 方法 如果要為欄位建立 getter 和 setter 方法,請選取欄位的宣告,並呼叫程式檔 > 產生 getter 和 setter。

「產生 getter 和 setter」對話框

如果使用名稱字首或字尾,請務必在 開啟程式碼樣式喜好設定頁面 Java > 程式碼樣式喜好設定頁面中加以指定。
建立 getter 與 setter 快速輔助 可提供欄位的快速輔助 (Ctrl+1),來建立 getter 與 setter。

此擷取畫面顯示建立 getter 與 setter 快速輔助

利用內容輔助來建立 getter 和 setter 建立 getter 和 setter 的另一個方法,就是使用內容輔助。 您可以將游標放在成員之間的類型主體中,然後按 Alt+/ 以取得建立 getter 或 setter 方法 Stub 的提議。
建立 setter 的內容輔助
連同欄位一起刪除 getter 和 setter 當您從視圖刪除欄位時,Eclipse 可能會提議連同其 getter 和 setter 方法一起刪除。 如果欄位使用名稱字首或字尾,請務必在 開啟「程式碼樣式」喜好設定頁面 Java > 程式碼樣式喜好設定頁面中加以指定。
建立委任方法 如果要建立欄位的委派方法,請選取欄位的宣告,再呼叫程式碼 > 產生委派方法。 這將新增選取的方法至含有至委派的方法之轉遞呼叫的類型。 下面就是一個委派方法的範例:
委派方法範例
建立 hashCode() 和 equals() 如果要建立 hashCode() 和 equals() 方法,請呼叫程式碼 > 產生 hashCode() 和 equals()。

「產生 hashCode() 和 equals()」對話框

使用範本來建立方法 範本會與內容輔助 (Alt+/) 提議一起顯示。
您可以使用現有的範本,例如 'private_method'、'public_method'、'protected_method' 等等,或者也可以為方法 Stub 定義新範本。

在套用範本之後,可以使用 Tab 鍵,在要輸入的值(傳回類型、名稱和引數)之間導覽。
具備新方法範本提議的內容輔助

使用範本來建立 SWT 小組件 如果專案的類別路徑中含有 SWT 程式庫,您可以使用內容輔助 (Alt+/) 來建立 SWT 小組件。

例如,如果要新增 SWT 按鈕,請輸入 Button,按下 Alt+/,選取 Button SWT 範本,然後按 Enter 鍵。

使用 Button 範本來建立按鈕

如果要查看所有可用的範本,請移至 開啟「範本」喜好設定頁面 Java > 編輯器 > 範本喜好設定頁面,或透過視窗 > 顯示視圖 > 其他...,開啟「範本」視圖。

建立您自己的範本 如果要建立自己的範本,請移至 開啟「編輯器範本」喜好設定頁面 Java> 編輯器 > 範本喜好設定頁面,按新建按鈕來建立範本。 例如,在陣列中向後疊代的範本看起來如下:

疊代子範本

使用快速修正程式來建立新方法 從呼叫方法開始,然後使用快速修正程式 (Ctrl+1) 來建立方法。

「create 方法」快速修正程式

利用快速修正程式來變更方法簽章 您可以在呼叫網站上,把引數加到方法呼叫中。 然後再使用快速修正程式 (Ctrl+1),把必要的參數加到方法宣告中。

「變更簽章」快速修正程式

使用內容輔助來建立建構子 Stub 在您要新增建構子的位置,在輸入建構子名稱的第一個字母之後,使用內容輔助。
利用內容輔助建立建構子
從參數建立新欄位 您需要建立新欄位來存放傳入建構子中的引數嗎? 您可以對參數使用快速輔助 (Ctrl+1) 來建立指派和欄位宣告,並讓 Eclipse 根據「程式碼樣式」喜好設定來提議名稱。
「指派參數給新欄位」快速輔助
使用內容輔助來置換方法 在類型主體中應該加入方法的位置,呼叫內容輔助 (Alt+/)。內容輔助將提供所有可以被置換的方法。 將建立所選方法的方法主體。

「置換方法」內容輔助

使用「快速修正程式」來新增未實作的方法 如果要實作新的介面,請先新增 'implements' 宣告至類型。 即使沒有儲存或建置,Java 編輯器也會強調以訊號顯示該類型,表示該方法遺漏,並且顯示快速修正程式燈泡。 您可以按一下燈炮,或按下 Ctrl+1(編輯 > 快速修正程式),選擇要新增未實作的方法,或者讓類別成為 abstract。

快速修正程式提供「新增未實作的方法」提議

使用「清除」來新增未實作的方法 在您將方法新增至介面,或是將抽象方法新增至抽象類別時,Eclipse 可以在所有的具體子類別中同時產生方法 Stub。請針對一組 Java 元素呼叫程式碼 > 清除...,使用自訂設定檔,然後在配置... 對話框的遺漏的程式碼標籤中,選取新增未實作的方法。
置換基礎類別的方法 如果要建立一個方法,來置換基礎類別的方法,請執行下列動作:
選取應該新增方法的類型,並呼叫程式碼 > 置換/實作方法。 這時會開啟一個對話框,讓您選擇要置換的方法。

「置換/實作方法」對話框

在檔案中重新命名如果要快速進行不需要在其他檔案中完整分析相依關係的重新命名,請使用「在檔案中重新命名」快速輔助。在 Java 編輯器中,將游標定位在變數、方法或類型的識別碼,然後按下 Ctrl+1(編輯 > 快速修正程式)
編輯器會切換至鏈結的編輯模式(如同範本),而且變更識別碼將同時變更該變數、 方法或類型的所有其他參照。

利用「本端重新命名」快速修正程式來變更多個 ID

您也可以使用直接捷徑 Ctrl+2 R。請利用 開啟按鍵喜好設定頁面 一般 > 按鍵喜好設定頁面來配置捷徑(在「來源」種類中)。
使用快速修正程式來處理異常狀況 要處理擲出的異常狀況並不難。輸入時,會偵測未處理的異常狀況,並在編輯器中以紅線標示。
  • 按一下燈炮,或按下 Ctrl+1,以 try/catch 區塊包覆呼叫。如果您想要在 try 區塊中併入多個陳述式,請選取這些陳述式,再使用來源 > 包覆 > try/catch 區塊。 您也可以利用編輯 > 展開選項至,再選取含括、下一步或上一步,來選取個別陳述式。
  • 如果已用 try 區塊包覆呼叫,快速修正程式將建議新增 catch 區塊至現有的區塊。
  • 如果您不想要處理異常狀況,讓快速修正程式新增擲出異常狀況至含括方法宣告中。

「未捕捉到異常狀況」快速修正程式提議

您隨時都可以將 catch 區塊轉換成擲出的異常狀況。 請對 catch 區塊使用 Ctrl+1(編輯 > 快速修正程式)。

「把 catch 子句換成 throws」快速輔助

更少輸入指派 不輸入指派,改為以將指派的表示式開始。

「指派陳述式給區域變數」快速輔助

您可以使用 Ctrl+1(編輯 > 快速修正程式),再選取「指派陳述式給新區域變數」,「快速輔助」便會猜測變數名稱。
快速輔助指派
減少使用強制轉型表示式 別花太多時間在輸入強制轉型。先略過它們,等完成陳述式之後,再利用快速輔助加入它們。

例如,以指派作業為例:
將強制轉型新增至指派作業中
或方法引數:
加入方法引數的強制轉型
或方法呼叫目標:
在方法呼叫目標中加入強制轉型

指派強制轉型表示式
在 'instanceof' 檢查之後,通常會強制轉型表示式,再將它指派給新的區域變數。請對 'instanceof' 關鍵字或在區塊主體開頭呼叫快速輔助 (Ctrl+1),來節省輸入的時間:
「提供含強制轉型類型的新區域變數」快速修正程式
包覆字行 如果要以 if / while / for 陳述式或區塊來包覆陳述式,請選取要包覆的行,再呼叫原始碼 > 包覆方式或按 Alt+Shift+Z。

「以範本包覆」快速輔助

功能表中的項目是從正常編輯器範本衍生而來:所有包含 ${line_selection} 變數的範本都會顯示在功能表中。

您可以在 開啟「編輯器範本」喜好設定頁面 Java > 編輯器 > 範本喜好設定頁面中配置範本。 請編輯相對應的範本來自訂產生的程式碼,或定義您自己的包覆方式範本。
其他快速輔助和修正
查看快速輔助頁面,以取得可用之程式碼轉換的完整清單。您可於這裡取得快速修正程式的清單。
快速修正程式和輔助的快速鍵
某些常用的快速輔助(例如:在檔案中重新命名和指派給區域變數),可以直接利用 Ctrl+2 R 和 Ctrl+2 L 來呼叫。如需其他支援直接呼叫的快速修正程式與快速輔助,請查看 開啟「按鍵」喜好設定頁面 一般 > 按鍵喜好設定頁面。

在過濾器欄位中輸入 "Quick Assist" 或 "Quick Fix":

含有快速輔助快速鍵的按鍵喜好設定頁面

內容輔助可以自動插入引數名稱 您可以讓內容輔助在方法完成時,自動插入引數名稱。 您可以在 開啟「內容輔助」喜好設定頁面 Java > 編輯器 > 內容輔助喜好設定頁面中,自訂這項行為(請參閱填寫方法引數,並顯示猜測的引數勾選框)。 例如,當您在此處選取第二個項目時,

內容輔助視窗

內容輔助會自動插入引數名稱:

內容輔助插入的引數名稱

之後,您可以利用 Tab 鍵來導覽插入的名稱。

如果您選擇插入最佳猜測引數,依預設,會填寫最佳的猜測。而替代的提議仍然是可用的。

自動插入類型引數
當在 J2SE 5.0 中使用參數化類型時,在 開啟「內容輔助」喜好設定頁面 Java > 編輯器 > 內容輔助喜好設定頁面中啟用填寫方法引數,並顯示猜測的引數,也很有用。
參數化類型的內容輔助
產生:
內容輔助猜測和插入的類型引數
移除包覆的陳述式 如果要移除包覆的陳述式或區塊,請將游標放在左或右方括弧上,再按 Ctrl+1(編輯 > 快速修正程式)。

「移除包覆的陳述式」快速輔助

那個字該怎麼拼? 您可以在 開啟「拼字」喜好設定頁面 一般 > 編輯器 > 文字編輯器 > 拼字喜好設定頁面中,啟用 Java 編輯器中的拼字檢查支援。 拼字錯誤會顯示在 Java 編輯器,同時也有對應的快速修正程式供您使用:

拼字更正提議的範例。

您也可以讓內容輔助使用該字典。 「快速修正程式」可讓您即時在使用者字典中新增單字。

結構化選項 「結構性選項」動作可用來將現行選項擴大至下一個含括元素:

請強調顯示這個文字,按 Alt+Shift+上移鍵,或從功能表列中選取編輯 > 展開選項至 > 含括元素,這時選項會展開成包含這個選項的最小 Java 語法元素。接著,您可以再次呼叫該動作(或是「展開選項至」功能表中的其他動作),來進一步展開選項。

例如,這有助於選取含括 ID 來重新命名,或有助於選取相鄰的陳述式來進行後續的「擷取方法」重構。

尋找對稱的括弧 如果要尋找對稱的方括弧,請選取左或右方括弧,再按 Ctrl+Shift+P 或選取導覽 > 移至 > 對稱的方括弧。 您也可以按兩下方括弧旁 - 這樣會選取兩個方括弧之間的文字。

使用「按兩下」,選取兩個方括弧之間的文字

Java 編輯器也支援強調顯示含括的方括弧。

含括的方括弧

您可以在 開啟 Java 編輯器喜好設定頁面 Java > 編輯器喜好設定頁面中配置這個項目。

智慧型 Javadoc 輸入 '/**',然後按 Enter 鍵。這會自動新增包含標準 @param、@return 和 @exception 標籤的 Javadoc 註解 Stub。

「智慧型 Javadoc」的結果

您可以在 開啟「程式碼範本」喜好設定頁面 Java> 程式碼樣式 > 程式碼範本喜好設定頁面中,配置新註解的範本。
使用本端歷程來回復至先前方法的版本 每當您編輯檔案時,它的先前內容會保存在本端歷程中。Java Tooling 會使得本端歷程可供 Java 元素使用,以便您可以回復至先前編輯的單一方法的前版本,而非完整檔案。

請選取一個元素(例如,在「大綱」視圖中),利用取代為 > 本端歷程來回復到先前編輯的元素。

從本端歷程取代對話框

使用本端歷程來還原已移除的方法 每當您編輯檔案時,它的先前內容會保存在本端歷程中。Java Tooling 會使得本端歷程可供 Java 元素使用,以便您可以選擇性還原已刪除的方法。

請選取一個儲存器(例如,在「大綱」視圖中),利用從本端歷程還原來還原任何已移除的成員。

從本端歷程對話框還原

產生可自訂的程式碼 開啟「程式碼範本」喜好設定頁面 Java > 程式碼樣式 > 程式碼範本喜好設定頁面可讓您依照類似正常範本的方式來自訂產生的程式碼和註解。 只要一產生程式碼,就會用到這些程式碼範本。

「程式碼範本」喜好設定頁面

從 3.1 開始,可以使用特定專案專用的程式碼範本,如果專案是共用的,團隊也會共用這個範本。 請對專案開啟內容,來啟用專案的特定設定。
在程式碼中建立註解 您可以利用程式碼 > 產生元素註解 (Alt+Shift+J) 來明確新增註解,或由各種精靈、重構作業或快速修正程式來自動新增註解。
請在 開啟「程式碼範本」喜好設定頁面 Java > 程式碼樣式 > 程式碼範本喜好設定頁面中,配置註解範本。
您可以直接在精靈中啟用或停用自動產生註解的功能(例如,在各種新建 Java 類型的精靈中使用產生註解勾選框),或利用 開啟「程式碼範本」喜好設定頁面 Java > 程式碼樣式 > 程式碼範本喜好設定頁面中的自動新增新方法和類型的註解勾選框,來執行這個動作。
所有這些設定也都可以依每個專案來配置。請對專案開啟內容,來啟用專案的特定設定。
排序成員 您可以依照 開啟「成員排序順序」喜好設定頁面 Java > 外觀 > 成員排序順序喜好設定頁面中定義的種類順序,針對 Java 編譯單元或一組編譯單元來排序成員。
這個動作在程式碼 > 排序成員之下。
字串折行 當編輯「字串」文字時,您可以讓它們折行。例如,如果程式碼如下:
String message= "This is a very long message.";

請將脫字符號 (^) 放在 "very" 這個字的後面,然後按 Enter 鍵。 這個程式碼將自動改為:

String message= "This is a very" +
           " long message.";

您可以在 開啟「輸入」喜好設定頁面 Java > 編輯器 > 輸入喜好設定頁面中自訂這個行為。

智慧型輸入以及控制它的方法 Java 編輯器的智慧型輸入特性,可以減輕日常工作的負擔。 您可以在 開啟「輸入」喜好設定頁面 Java > 編輯器 > 輸入喜好設定頁面中配置它們。

Java 編輯器的「輸入」喜好設定頁面

如果您啟用在正確的位置自動插入分號,輸入分號時會在插入分號之前,自動將游標定位在陳述式尾端。這樣可以省下一些額外的游標導覽。
如果要復原這個自動定位作業,可以在這之後立刻按倒退鍵。

以一個按鍵修正程式碼縮排 原始碼 > 更正縮排或 Ctrl+I 是一個非常有用的特性。
請選取縮排不正確的程式碼,再呼叫這個動作。

如果未選取任何項目,這個動作會將目前這一行縮排。

儲存時修正程式碼縮排 在您儲存編輯器時,Eclipse 可以更正您程式碼的縮排。請移至 開啟「儲存動作」喜好設定頁面 Java > 編輯器 > 儲存動作喜好設定頁面,以及配置... 其他動作,並在程式碼組織標籤中選取更正縮排。
程式碼和重構動作的快速功能表 您可以透過快速功能表,來存取重構和程式碼動作。 請選取要在 Java 編輯器或 Java 視圖中操作的元素,再按 Alt+Shift+S 來取得快速原始碼功能表,或按 Alt+Shift+T 來取得快速重構功能表,以及按 Alt+Shift+Z 來取得包覆方式功能表。

快速重構功能表

尋找未用的程式碼 Java 編譯器會偵測無法呼叫到的程式碼、未使用的變數、參數、匯入項目和未使用的 private 類型、方法和欄位。在 開啟錯誤/警告喜好設定頁面 Java > 編譯器 > 錯誤/警告喜好設定頁面,以變更偵測設定。您也可以針對個別的專案,來指定這些設定,其作法是使用:專案 > 內容 > Java 編譯器 > 錯誤/警告。

編譯器喜好設定頁面

在您輸入這些問題時,就會開始偵測,並且會提供一個快速修正程式來移除不必要的程式碼。您也可以使用程式碼 > 清除...,來移除未用的程式碼。
尋找空值問題 編譯器可協助您尋找程式碼中的 null 問題。 開啟「錯誤/警告」喜好設定頁面 Java > 編譯器 > 錯誤/警告喜好設定頁面提供三個選項來偵測問題:
  • 存取空值指標(位於「潛在的程式設計問題」)
    如以下範例所示,當啟用這個選項時,只要使用在靜態情況下已知會保留空值的變數,來存取欄位或方法時,編譯器就會發出錯誤或警告:

    「存取空值指標」範例


  • 存取潛在的空值指標(位於「潛在的程式設計問題」)
    如以下範例所示,當啟用這個選項時,只要在靜態情況下已知變數可能會保留空值,編譯器就會發出錯誤或警告:

    「存取潛在的空值指標」範例


  • 檢查冗餘的空值(位於「不必要的程式碼」)
    如以下範例所示,當啟用此項時,只要使用在靜態情況下已知會保留空值或非空值的變數,來測試空值,編譯器就會發出錯誤或警告:

    「檢查冗餘的空值」範例(instanceof 一律為 false)


    「檢查冗餘的空值」範例

尋找提出之字串的問題 程式碼 > 尋找毀損的提出字串動作會自動尋找未定義、未使用及重複的索引鍵:

提出的字串搜尋結果範例

變更問題浮動說明中的問題嚴重性 如果您已充實問題浮動說明(按 F2 或將滑鼠移至浮動說明),則會提供一個動作,供您變更現行問題的嚴重性。

充實的問題浮動說明

按一下工具列中的按鈕,以移至 開啟「錯誤/警告」喜好設定頁面 Java > 編譯器 > 錯誤/警告喜好設定頁面。

處理 Javadoc 註解 Eclipse Java 編譯器可以處理 Javadoc 註解。 搜尋報告會參照 doc 註解,而重構會更新這些參照。 這項特性從 開啟「Javadoc 問題」喜好設定頁面 Java > 編譯器 > Javadoc 喜好設定頁面中進行控制(或利用專案 > 內容 > Java 編譯器 > Javadoc 來設定個別專案的這項設定)。

Javadoc 喜好設定頁面

如果開啟,Java 編輯器中就會標示形態異常的 Javadoc 註解,且可以利用編輯 > 快速修正程式 (Ctrl+1) 來修正:

Javadoc 偵測到的問題

暫停警告 在 J2SE 5.0 和更新的版本中,您可以利用 SuppressWarnings 註釋來暫停所有選用的編譯警告。
在這個範例中,addAll() 標示為未用的方法。快速修正程式 (Ctrl+1) 用來新增 SuppressWarnings 註釋,以便不顯示這個方法的警告。
新增 SuppressWarning 註釋的快速修正程式
清除 程式碼 > 清除... 可協助您同時修正多個問題,並協助您建立一致的程式碼樣式。例如,您可以:
  • 儘可能將所有 for 迴圈轉換成加強型 for 迴圈。
  • 利用 @Override 註釋來標示整個專案中的所有置換方法。
  • 組織匯入項目
  • 將程式碼格式化
  • 移除不必要的程式碼

「清除」會加以組織並放在「清除」設定檔中。設定檔可以連接至工作區或個別的專案。專案設定可以透過版本控制系統在團隊中共用。此外,也能夠匯出與匯入每一個設定檔。

「清除」喜好設定頁面

「清除」可以在儲存時當成儲存動作來執行。請移至 開啟「儲存動作」喜好設定頁面 Java > 編輯器 > 儲存動作喜好設定頁面,以配置儲存時要呼叫哪些清除動作。

重構

重構 Scripting JDT 所提供的大部分重構都無法以互動方式來執行,只能由重構 Script 來執行。

請利用重構 > 建立 Script...,從重構歷程中建立重構 Script。

之後,便可以利用重構 > 套用 Script...,在任意工作區上套用重構 Script。

您可以在不同的實務中使用這些重構 Script,例如,修正在各軟體層之間中斷的 API 變更,或提供含有豐富語意的修補程式。
安全 JAR 檔移轉 當從工作區匯出 JAR 檔時,「JAR 匯出」精靈會提供將重構資訊引進 JAR 檔的選項。

請利用檔案 > 匯出...,再選取 JAR 檔。 在「JAR 匯出」精靈的首頁中,選取匯出檢查之專案的重構。 請按一下鏈結來選取要併入的重構。

之後,用戶端便能夠利用重構 > 移轉 JAR 檔... 重構,將舊版 JAR 檔移轉至新的版本。 這項重構會自動更新所有相依於舊版 JAR 檔的程式碼來使用新版的 JAR 檔。

搜尋

尋找變數及其讀寫權 您可以選取一個 ID(變數、方法、類型參照或宣告),並呼叫搜尋 > 檔案中的出現處 > ID,來尋找變數,並查看其讀寫狀態。 此舉會標示同一檔案中該識別碼的所有參照。搜尋視圖中也會顯示結果,且讀取權或寫入權以不同的顏色標示,也會附上圖示以顯示變數的讀取權或寫入權。

欄位的讀寫權

另外,您也可以使用標示出現項目特性,來動態強調顯示出現項目。 您可以使用一般搜尋特性來搜尋數個檔案(搜尋 > 參照)。

搜尋具有特定傳回類型的方法 如果要搜尋含特定傳回類型的方法,請依照下列方式來使用 "* <return type>":
  • 開啟搜尋對話框,再按一下 Java 搜尋標籤。
  • 在搜尋字串中輸入以空格隔開的 '*' 和傳回類型。
  • 選取區分大小寫勾選框。
  • 選取方法和宣告,然後按一下搜尋。

以給定的傳回類型來搜尋方法

過濾器在 Javadoc 中搜尋相符項 依預設,Java 搜尋會在 Java 程式碼和 Javadoc 中尋找參照。 如果您不要在 Javadoc 內看到參照,您可以啟用「搜尋」視圖之「檢視」功能表中的「過濾 Javadoc」(三角形符號)來過濾這些相符項。
過濾潛在的搜尋相符項 當編譯時期問題使搜尋引擎無法完整解析相符項時,便可能出現潛在的相符項。 請利用搜尋視圖功能表(三角形符號)中的過濾潛在項目來過濾這些相符項。
以呼叫階層來追蹤方法呼叫鏈 請利用「呼叫階層」,既遵循著長或複雜的呼叫鏈,又不失去原始的環境定義:您只需要選取一個方法,再呼叫導覽 >開啟呼叫階層 (Ctrl+Alt+H) 即可。

「呼叫階層」視圖

您也可以利用拖放方式,將視圖輸入取代為選取的方法。 Ctrl+拖曳方式會將選取的方法新增到視圖中的現有元素。

依預設,匿名類別或特殊類型(如 Runnable)的方法會以建構子展開,因為查看物件的建立位置通常會比查看方法的呼叫置更令人關注的。 快速功能表中的以建構子展開可切換此行為。您可以在視圖功能表中配置預設值。

程式碼導覽和讀取

在 Java 編輯器中開啟選項 在 Java 編輯器中,有兩種方式可從參照中開啟元素。
  • 選取程式碼中的參照,並按下 F3(導覽 > 開啟宣告)
  • 按住 Ctrl,將滑鼠指標移到參照之上,按一下超鏈結
超鏈結樣式導覽

對可置換的方法按住 Ctrl 鍵會顯示一個含有開啟實作項目的蹦現畫面; 如果只有一個實作,其會直接開啟實作;您也可以利用快速類型階層, 在該方法的宣告類型階層中顯示其所有具體實作。

您可以在 開啟超鏈結喜好設定頁面 一般 > 編輯器 > 文字編輯器 > 超鏈結喜好設定頁面中配置超鏈結樣式導覽。
原位大綱 在 Java 編輯器中按下 Ctrl+F3,以在現行游標位置蹦現元素的原位大綱。或者按 Ctrl+O(導覽 > 快速大綱),以蹦現現行程式檔的原位大綱。

原位大綱

原位大綱會顯示繼承的成員 再按一次 Ctrl+O 或 Ctrl+F3,把繼承的成員加到一個開啟的原位大綱中。 繼承的成員會有藍色標籤。 您可以利用右上角的功能表來過濾和排列大綱。

「快速大綱」視圖

快速大綱 (Ctrl+O) 也會顯示包含現行編輯器選項之類型的繼承成員。可以顯示繼承成員的焦點類型會標示一個三角形(焦點裝飾)。
原位階層 利用快速類型階層來找出哪些是虛擬呼叫可能的接收端。 將游標放在方法呼叫內,按 Ctrl+T(導覽 > 快速類型階層)。 這個視圖會以完整的圖示,顯示所有實作方法的類型。

「快速類型階層」對話框

按 Enter 鍵來開啟編輯器中相對應的方法。 再按一次 Ctrl+T,切換至「超類型」階層。

Java 編輯器瀏覽途徑 Java 編輯器含有一個瀏覽途徑導覽列,顯示位於游標位置之元素的路徑。瀏覽途徑可以透過切換瀏覽途徑工具列或按下 Alt+Shift+B 來啟用。

Java 編輯器瀏覽途徑

瀏覽途徑中的每一個元素都可以選取,並且可以透過快速功能表或鍵盤快速鍵來呼叫動作。再者,瀏覽途徑可讓您透過下拉清單,導覽至其他元素。

進階強調顯示 Java 編輯器可以根據程式碼的語意,來強調顯示程式碼(例如:static 欄位、區域變數、static 方法呼叫)。 請查看 開啟「語法著色」喜好設定頁面 Java > 編輯器 > 語法著色喜好設定頁面的各個選項。

進階強調顯示的範例。

最初的摺疊區域 您可以指定當編輯器開啟時,依預設會摺疊哪些區域。請查看 開啟「摺疊」喜好設定頁面 Java > 編輯器 > 摺疊喜好設定頁面來加以自訂。

摺疊喜好設定頁面

標示搜尋結果 在編輯器中作業時, 請開啟工具列中的標示出現項目(「標示出現項目」工具列按鈕的圖片),或按 Alt+Shift+O。您會在檔案內看到參照某個變數、方法或類型的位置。

標示 'info' 搜尋結果的編輯器

使用不同的顏色來標示讀取權和寫入權。

當您選取一個傳回類型之後,畫面便會出現方法的結束點。 請選取一個異常狀況,看看擲出它的地方。 您可以選取超類別或介面來查看被置換的方法,或從選定的超類型來實作方法。

請在 開啟「標示出現項目」頁面 Java > 編輯器 > 標示出現項目喜好設定頁面中,細部調整「標示出現項目」。
請在 開啟註釋頁面 一般 > 編輯器 > 文字編輯器 > 註釋喜好設定頁面中,變更標記的顏色。

如果要在「搜尋」視圖中顯示「出現處」,請使用搜尋 > 出現處特性。

移至下一個 / 上一個方法 如果要快速導覽至下一個或上一個方法或欄位,請使用
Ctrl+Shift+上移鍵(導覽 > 移至 > 上一個成員),或 Ctrl+Shift+下移鍵(導覽 > 移至 > 下一個成員)
註釋導覽控制 您可以使用「下一個/上一個註釋」工具列按鈕或是導覽 > 下一個註釋 (Ctrl+.) 和導覽 > 上一個註釋 (Ctrl+,),在 Java 程式檔中的註釋之間導覽。 您可以利用按鈕下拉功能表,來配置您要停在哪些註釋:

下一個/上一個註釋下拉功能表。

Java 程式碼中的提示 當您在 Java 程式碼中以 "TODO" 標示註解時,Java 編譯器就會自動建立一個對應作業,作為提示。開啟作業可讓您導覽回程式碼中的 "TODO"。請利用 開啟 todo 頁面 Java > 編譯器 > 作業標籤喜好設定頁面來配置您想要在作業清單中追蹤的任何其他特殊標籤(如 "FIXME")。

編輯器和作業視圖中的作業標籤

「開啟類型」對話框中的秘訣
「開啟類型」對話框(導覽 > 開啟類型或工具列按鈕)可協助您依類型名稱來導覽至類型。
  • 如果要快速尋找類型,您只需輸入類型名稱的大寫字母:
    IOOBE 會找到 IndexOutOfBoundsException。
    或輸入每一個名稱部分的前幾個字元:
    NuPoiE 會找到 NullPointerException。
  • 如果要查看含給定字尾的所有類型,例如,所有 Tests,使用 *Test< 便不會看到所有在類型名稱的其他位置含有 Test 的類型。
  • 如果要一次開啟多種類型,請在清單中選取它們,並按一下「確定」。
含有駝峰式大小寫相符的「開啟類型」對話框
使浮動說明重複複製 您可以按下 F2(編輯 > 顯示工具提示說明),或將滑鼠指標移至浮動說明上, 在可捲動的視窗中開啟浮動說明中的文字。您可以從這個視窗選取和複製內容、呼叫動作,或是遵循鏈結。

含有浮動說明內容的視窗

您可以在 開啟「文字編輯器」喜好設定頁面 一般 > 編輯器 > 文字編輯器喜好設定頁面中,配置如何充實浮動說明。

Java 編輯器中的浮動說明 您可以在 Java 編輯器中利用修正鍵 (Shift、Ctrl、Alt) 來看到不同的浮動說明。
當您在 Java 編輯器中將滑鼠移過沒有警告或問題註釋的 ID 時,依預設會顯示一個浮動說明,其中含有從這個元素的對應程式碼所擷取的 Javadoc。如果 ID 有問題註釋,則浮動說明會顯示對應的訊息。按住 Shift 鍵會顯示原始碼:

在浮動說明內顯示元素程式碼的浮動說明

您可以在 開啟「浮動說明」喜好設定頁面 Java > 編輯器 > 浮動說明喜好設定頁面中,變更這個行為及定義其他修飾元的浮動說明。
一般方法推斷的簽章
您可以利用浮動說明來顯示一般的方法的推斷簽章。

顯示一般方法推斷簽章的浮動說明

開啟和配置外部 Javadoc 文件 如果您想要 利用 Shift+F2(導覽 > 開啟外部 Javadoc),來開啟類型、方法或欄位的 Javadoc 文件,必須先指定元素母項程式庫(JAR、類別資料夾)或專案(來源資料夾)的文件位置。
對於程式庫,請開啟建置路徑頁面(專案 > 內容 > Java 建置路徑),移至程式庫,展開程式庫節點,這裡可以編輯「Javadoc 位置」節點。 文件可以放在本端檔案系統的資料夾中,也可以放在保存檔或 Web 伺服器中。

在「Java 建置路徑」對話框配置 Javadoc 位置

對於來源資料夾中的類型、方法或欄位,請移至(專案 > 內容 > Javadoc 位置)。

Java 視圖

組織含有許多專案的工作區 請利用「套件瀏覽器」視圖功能表中的最上層元素 > 工作集來啟用將工作集顯示為最上層元素的新模式。 這個模式會使得管理含有許多專案的工作區更加容易。

「工作集」模式下的套件瀏覽器

請利用「套件瀏覽器」此擷取畫面顯示中的配置工作集...,來配置要顯示的工作集。 這個對話框可讓您建立新的 Java 工作集、定義要顯示哪些工作集,以及顯示的順序。 如果未啟用排序工作集,您也可以直接在「套件瀏覽器」中,利用拖放方式來重新排列工作集。

指派工作集 如果要將元素指派給不同的工作集,請在「套件瀏覽器」中選取元素,並從快速功能表中選擇指派工作集...。

此擷取畫面顯示工作集指派對話框

「宣告」視圖 「宣告」視圖(開啟「Java 宣告」視窗 視窗 > 顯示視圖 > 其他... > Java > 宣告) 會顯示 Java 編輯器或 Java 視圖中選取元素的程式碼。

「宣告」視圖

Javadoc 視圖 Javadoc 視圖(開啟 Javadoc 視圖 視窗 > 顯示視圖 > 其他... > Java > Javadoc) 會顯示 Java 編輯器或 Java 視圖中選取元素的 Javadoc。

Javadoc 視圖

「類型階層」視圖和方法實作 / 定義 如果要瞭解階層中哪些類型會置換方法, 請使用「顯示階層中的成員」特性:
  1. 選取要查看的方法,然後按下 F4(導覽 > 開啟類型階層)。這會根據方法的宣告類型來開啟「類型階層」視圖。
  2. 如果「類型階層」視圖已經選取該方法,請按「鎖定視圖及顯示階層中的成員」工具列按鈕。
「類型階層」視圖現在只會顯示實作或定義「已鎖定」方法的類型。例如,您可能會看到 isEmpty() 定義在 List 中,在 ArrayList 和 Vector 中實作,但不在 AbstractList 中實作。

鎖定視圖並且顯示階層中的成員

「類型階層」視圖支援透過定義類型來分組 類型階層方法視圖可讓您依照其定義的類型,排序選取的類型方法。 例如,如果是 AbstractList,您可能會看到它含有已定義在 Object、Collection 和 List 中的方法:

根據類型階層中的定義類型,對成員排序

類型階層中的秘訣
  • 在元素或選取的名稱上按 F4(導覽 > 開啟類型階層),將類型階層的焦點放在新類型。
  • 您不只可以開啟「類型階層」視圖來顯示類型,也可以顯示套件、來源資料夾、JAR 保存檔與 Java 專案。您可以選取多個套件、來源資料夾,或專案,然後開啟包含所選儲存器中之所有類型的階層。
  • 您可以將元素拖放至「類型階層」視圖,以便將焦點放在該元素上。
  • 您可以從視圖的工具列功能表,變更「類型階層」視圖的方向(從預設的垂直到水平)。
Java 程式檔的結構比較 Java 程式檔的結構比較會忽略 Java 元素(如方法和欄位)的文字次序,而更清楚的顯示哪些元素已經變更、新增或是移除。
您可以選擇下列一種方法,來起始 Java 檔的結構比較:
  • 選取兩個 Java 編譯單元,然後從視圖的快速功能表選取相互比較 > 彼此。 如果檔案不一樣,將以「比較編輯器」開啟它們。 窗格頂端會顯示不同的 Java 元素;如果按兩下其中一個元素,便會在窗格底端顯示該元素的程式檔。
  • 在任何包含檔案比較的環境定義中(如 CVS 同步化) 按兩下 Java 檔,不僅可以文字比較檢視器顯示檔案內容,還會執行結構比較,並且開啟新窗格來顯示結果。

Java 程式碼的結構比較

在執行結構比較時,您甚至可以忽略格式化變更:透過「比較編輯器」的工具列按鈕,或比較檢視器的快速功能表,來開啟忽略空格選項。
內容檔的結構比較 Java 內容檔(副檔名:.properties)的結構比較會忽略內容的文字次序,而更清楚的顯示哪些內容已經變更、新增或是移除。
您可以選擇下列一種方法,來起始內容檔的結構比較:
  • 在「套件瀏覽器」或「導覽器」中選取兩個檔案,然後從視圖的快速功能表選取相互比較 > 彼此。
  • 在任何包含檔案比較的環境定義中(如 CVS 同步化),按兩下內容檔不僅可以在文字比較檢視器顯示檔案內容,還會執行結構比較,並且開啟新窗格來顯示結果。

內容檔的結構比較

套件的階層式和平面式呈現 在「Java 套件」(和「套件瀏覽器」)視圖上,有一個選項可讓您變更套件的顯示方式。套件呈現 > 階層式會以樹狀結構顯示套件,在套件之下有子套件;套件呈現 > 平面式會以標準排列來顯示它們,將它們顯示成一份平面式清單,所有套件和子套件都顯示成同層級。
平面式套件佈置 階層式套件佈置
邏輯套件 「Java 套件」視圖 (「Java 瀏覽」視景)會在專案內跨來源資料夾聯合同名的套件。 此擷取畫面顯示含有邏輯套件的「套件」視圖。

含有邏輯套件的 Java 瀏覽視景

壓縮套件名稱 如果套件名稱很長,您可以配置一個檢視器所顯示的壓縮名稱。 壓縮型樣的配置是在 開啟「外觀」喜好設定頁面 Java > 外觀喜好設定頁面中完成的。

Java 外觀喜好設定頁面中的壓縮型樣配置

使用這個範例,將以下列方式展現套件:

壓縮的套件名稱

套件名稱的縮寫 您可以用自訂規則來縮寫 Java 視圖中的套件名稱。例如,下列規則會產生下面所示的呈現:
org.eclipse.ui={UI}
org.eclipse.ui.texteditor={T}
org.eclipse.ui.internal.texteditor=[iT]
不縮寫: 縮寫:
停用縮寫的「套件瀏覽器」 啟用縮寫的「套件瀏覽器」

您可以在 開啟「外觀」喜好設定頁面 Java > 外觀喜好設定頁面中配置縮寫規則。

直接在「套件瀏覽器」中操作 Java 建置路徑 您可以使用「套件瀏覽器」之快速功能表中的動作,而不需要在專案 > 內容 > Java 建置路徑中操作 Java 建置路徑。
例如,您可以新增來源資料夾、保存檔和程式庫到建置路徑中,或是從來源資料夾併入/排除檔案和資料夾。

「建置路徑」快速功能表

貼上程式碼片段以建立類型 您可以將包含 Java 類型的程式碼片段直接貼到套件或來源資料夾中,以建立新的編譯單元。 例如,選取並複製以下的原始碼:
package pack;
   public class HelloWorld {
      public static void main(String[] args) {
        System.out.println("Hello World");
    }
}
之後,在「套件瀏覽器」中選取一個來源資料夾,並使用 Ctrl+V(編輯 > 貼上)。 這會自動建立一個新套件 'pack',以及含有複製之內容的 'HelloWorld.java' 檔。

您也可以貼上方法或一組陳述式;Eclipse 會為您建立必要的含括元素。

如果您在「套件瀏覽器」中沒有選取就貼上,Eclipse 甚至會在該處建立新的 Java 專案,並建立 *.java 檔。再者,剪貼簿也可以包含多項套件與類型宣告,在這種情況下,Eclipse 會在貼上處建立所有必要的套件與 *.java 檔。

將修補程式貼到「套件瀏覽器」中 從 Bugzilla 套用修補程式的最快方式是什麼?您只要開啟附件, 將修補程式複製到剪貼簿,再將它貼到「套件瀏覽器」中。
分組 Java 問題 請配置「問題」視圖,利用視圖功能表中的分組依據 > Java 問題類型,將 Java 問題分組成各個種類。

含有已分組之問題的「問題」視圖圖片

您可以在 開啟「錯誤/警告」喜好設定頁面 Java > 編譯器 > 錯誤/警告喜好設定頁面底端,控制是否要將可配置的錯誤視為嚴重錯誤。
Java 類型指示器 請在 開啟「標籤裝飾」喜好設定頁面 一般 > 外觀 > 標籤裝飾喜好設定頁面中,啟用 Java 類型指示器來瞭解編譯單元或類別檔中的第一個類型是什麼。 介面、註釋和列舉都有裝飾,一般類別沒有裝飾。

Java 類型指示器標籤裝飾字元圖

細項

專案專屬的喜好設定 所有程式碼樣式和編譯器選項都可以依個別專案來定義。
請利用專案的專案 > 內容來開啟專案內容頁面,或利用工作區喜好設定的鏈結(如 開啟「程式碼樣式」喜好設定頁面 Java > 程式碼樣式喜好設定頁面)來開啟專案內容頁面,以及啟用專案專屬的設定。

含有「啟用專案專屬設定」勾選框的專案內容頁面

專案專屬的設定係儲存在專案內的配置檔中(於 '.settings' 資料夾中)。當您在團隊中共用專案時,團隊成員也會取得這些專案專屬的設定。
存取規則
存取規則讓您能夠從參照的程式庫強制實施類型的 API 規則。您可以在「Java 建置路徑」頁面(專案 > 內容 > Java 建置路徑)中,編輯可用於被參照之專案、保存檔、類別資料夾和程式庫的「存取規則」節點。
這些參照中的套件或類型可分類為:
  • 可存取
  • 不建議
  • 禁止
根據 開啟「錯誤/警告」喜好設定頁面 Java > 編譯器 > 錯誤/警告喜好設定頁面中的設定,編譯器會以警告或錯誤來標示不建議和禁止的參照。

存取規則配置對話框

JUnit 在視圖選取 JUnit 測試方法,然後從快速功能表選取執行 > JUnit 測試;或者從主功能表選取執行 > 執行方式 > JUnit 測試。 這會建立一個啟動配置來執行選取的測試。
隱藏 JUnit 視圖直到發生錯誤或失敗 您可以將 JUnit 視圖配置成只在發生錯誤或失敗時才開啟。 如果要執行這項作業,請在 JUnit 視圖功能表中啟用只在發生錯誤/失敗時啟動。如此一來,您可以讓這個視圖設成快速視圖,且在沒有失敗測試時從不查看它。如果測試沒有問題,那麼在執行它們時,您會看到這個圖示執行成功 (小綠色方塊的數目會隨之增加,指出進度),而且在完成它們之後,也會看到這個圖示 已經順利完成。 不過,如果發生錯誤或失敗,圖示就會變成 發生失敗或錯誤 (如果已經完成測試,則會變成已經完成但發生失敗或錯誤),而且會出現 JUnit 視圖。
對話框欄位中的內容輔助 內容輔助 (Alt+/) 也可用於各種 Java 對話框的輸入欄位中。請尋找焦點所在的欄位旁的小燈泡圖示。

「新建類別」對話框

顯示 Java 名稱之對話框中的智慧型脫字符號 (^) 定位 編輯 Java 名稱的文字欄位支援智慧型脫字符號 (^) 定位。 請利用 Ctrl+左和 Ctrl+右來停止於名稱內的駝峰式大小寫界限。 請利用 Ctrl+Shift+左和 Ctrl+Shift+右來小幅延伸選取範圍。 請利用 Ctrl+Delete 來刪除名稱的下一部分,利用 Ctrl+Backspace 來刪除名稱的上一部分。

對話框中的智慧型脫字符號 (^) 定位
Ctrl+右:
對話框中的智慧型脫字符號 (^) 定位
Ctrl+Shift+右:
對話框中的智慧型脫字符號 (^) 定位
寫入 "Equal":
對話框中的智慧型脫字符號 (^) 定位
Ctrl+Delete:
對話框中的智慧型脫字符號 (^) 定位
寫入 "To":
對話框中的智慧型脫字符號 (^) 定位
定義欄位、參數和區域變數的字首或字尾 您可以配置欄位、static 欄位、參數和區域變數的字首或字尾。 每當重新計算變數名稱時,內容輔助、快速修正程式和重構作業都會使用 開啟「程式碼樣式」喜好設定頁面 Java > 程式碼樣式喜好設定頁面的這些設定。

「程式碼樣式」喜好設定頁面中的命名慣例

組織匯入不僅可以在單一檔案上運作 您可以在編譯單元、套件、程式碼資料夾或 Java 專案上,呼叫程式碼 > 組織匯入項目。
儲存時組織匯入項目 只要您儲存編輯器,Eclipse 即可自動組織匯入項目。這項特性可在 開啟「儲存動作」喜好設定頁面 Java > 編輯器 > 喜好設定頁面喜好設定頁面中廣域啟用。您也可以針對個別的專案來配置儲存動作,而藉由讓團隊共用設定,施行專案層面的標準並不難:

「儲存動作」內容頁

除了組織匯入項目,儲存動作還能將程式碼格式化,並執行其他的清除動作。

格式選擇 選取多個要格式化的 Java 檔,再選擇程式碼 > 格式化,將它們全部格式化。製作格式動作也可以用在套件、來源資料夾或 Java 專案。

在「Java 編輯器」中,程式碼 > 格式化 (Ctrl+Shift+F) 只會將選取的區域格式化。如果都沒有選取,則會將整個檔案格式化。

選取 Java 專案的執行環境 在您建立要讓團隊共用的 Java 專案時,不妨使用執行環境而非特定的 JRE。

執行環境是 JRE 的符號式表示法,並且採用標準化輸入,例如 'J2SE-1.4'、'J2SE-1.5'。這表示不會有檔案系統路徑進入共用的建置路徑。

您可以在 開啟「執行環境」喜好設定頁面 Java > 已安裝的 JRE > 執行環境喜好設定頁面中,將 JRE 指派給環境。

「新建 Java 專案」精靈的擷取畫面

如果要設定現有專案的專案特定 JRE,請開啟專案的「Java 建置路徑」內容頁面(專案 > 內容 > Java 建置路徑)、開啟程式庫頁面、選取「JRE 系統程式庫」,然後按編輯。在「編輯程式庫」對話框中,您可以選取「執行環境」、「專案特定的 JRE」或「工作區預設的 JRE」。

使用拖放 拖放是編輯 > 剪下和編輯 > 貼上,或編輯 > 複製和編輯 > 貼上的一種便利替代方式。 在拖曳時按住 Ctrl 鍵,會從移動改成複製。

重要須知:

  • 如果您在套件之間,利用拖放來移動 Java 編譯單元,行為會類似於重構的移動,這時會新增所有遺漏的匯入項目並更新參照。
  • 如果您拖放類型或方法之類的程式碼元素,便只會複製或移動相對應的程式碼,不會更新任何參照
「延伸棄用」標籤 您可以利用 開啟「錯誤/警告」喜好設定頁面 Java > 編譯器 > 錯誤/警告喜好設定頁面的選項,配置 Java 編譯器來診斷淘汰的情況。

編譯器喜好設定頁面

如果使用這項配置,其結果如下:

I.java

X.java

Y.java

如果無法修正即將淘汰之建構的用法,建議您把含括的方法、欄位或類型,標示為即將淘汰。 這麼一來,您就可以確認您已經置換一個即將淘汰的建構,而淘汰旗標也會延伸到更進一步的相依關係。

X.java

Y.java

從異常不一致回復 在發生罕見的功能不良事件時,JDT 可能會發生一些不一致的情況,例如:
  • Java 搜尋或開啟類型遺漏結果
  • 「套件瀏覽器」中的項目無效

如果要使 JDT 返回一致狀態,您必須完全依照下列順序來執行下列動作:
  1. 利用導覽器關閉專案功能表動作,關閉所有的專案
  2. 結束和重新啟動 Eclipse
  3. 利用導覽器開啟專案功能表動作,開啟所有的專案
  4. 以手動方式觸發重新建置整個工作區(專案 > 清除...)
建置路徑錯誤裝飾字元 如果 Java 專案與工作集含有建置路徑錯誤,套件瀏覽器與專案瀏覽器會在它們當中顯示這個錯誤裝飾字元 建置路徑錯誤裝飾字元:

建置路徑錯誤裝飾字元

假設問題視圖中含有建置路徑錯誤,請先在套件瀏覽器中找出這個圖示,因為它會清楚指出問題所在。
'無原始檔的 *.class' 檔案類型 無原始檔的 *.class 檔案類型容許讓內部或外部編輯器與未附加原始檔的類別檔產生關聯。例如,這可讓您在反編譯器中開啟類別檔:

「檔案關聯」喜好設定頁面的擷取畫面

選擇性地忽略來源資料夾的錯誤/警告 您可以配置 JDT 來忽略某些來源資料夾的選用錯誤/警告。請參閱專案內容 > Java 建置路徑 > 編譯器 > 程式碼。

強調顯示「忽略選用性編譯問題」的 Java 建置路徑頁面

如果將這個選項設為是,JDT 會暫停 開啟「錯誤/警告」喜好設定頁面 Java > 編譯器 > 錯誤/警告喜好設定頁面中配置的錯誤/警告。 對於包含自動產生的類別或測試的來源資料夾,這可能很適合。

除錯

從快速功能表啟動

您可以從快速功能表執行及除錯 Java 應用程式。 您可以從視圖或編輯器中的快速功能表選擇執行方式(或除錯方式) > Java 應用程式,來啟動程式檔、套件、方法、類型等等。 另外,您也可以使用 Java 應用程式啟動快速鍵連結 (Alt+Shift+D、J)。 最上層執行方式(或除錯方式)動作對目前所選的項目或作用中的編輯器也有影響。

具有啟動選項的快速功能表

在除錯器中評估

您可以從除錯器的許多地方,使用片段評估。 如果從編輯器或「變數」視圖的快速功能表選擇顯示或檢查,則結果會顯示在蹦現畫面中,而結果也會傳到顯示或「表示式」視圖。

蹦現畫面中的檢查結果

在「非除錯」視景中管理視圖

「除錯」視圖會根據您所選的視圖(例如,顯示 Java 堆疊框的 Java 視圖,以及 C 堆疊框的 C 視圖),自動管理與除錯相關的視圖。 依預設,這個自動視圖管理只發生在「除錯」視景中,不過,您可以利用「除錯」視圖工具列下拉功能表所提供的視圖管理喜好設定頁面來啟用其他視景的這項功能。

環境變數

您可以利用環境標籤,指定用來啟動 Java 應用程式的環境。

「啟動配置」對話框中的環境標籤

置換字串

「Java 應用程式」啟動配置的許多參數都支援變數。 支援變數的大部分欄位旁都有變數... 按鈕,如:程式和 VM 引數欄位。主要類型欄位也支援變數;${java_type_name} 變數可讓您建立配置,執行您選取的類型。

「啟動配置」對話框中的「引數」標籤

邏輯結構

「變數」視圖工具列上的邏輯結構切換,會顯示共用類型的其他替代結構。 JDT 可以提供對映、集合和 SWT 複合元件的邏輯表示法。 您可以從邏輯結構喜好設定頁面中定義其他類型的邏輯結構。

在「變數」視圖中,向量是顯示為邏輯結構

變數直欄

您可以在視圖功能表中選取佈置 > 選取直欄...,以配置「變數」視圖中的直欄。對話框可讓您選取要顯示的直欄。例如,可以新增直欄,以顯示類別的實例計數(當使用 JavaSE-1.6 除錯時)。您可以使用佈置 > 顯示直欄動作,來開啟/關閉直欄。

用來在「變數」視圖中選取配置直欄的對話框

顯示在「變數」視圖中的直欄

顯示參照

當使用 JavaSE-1.6 除錯時,您可以選取視圖功能表中的 Java > 顯示參照,以便在「變數」視圖中顯示物件的參照。在每一個可展開的物件底下,會出現一個「參照自」項目,來顯示該物件的所有參照。

在「變數」視圖中顯示參照

所有實例

當使用 JavaSE-1.6 除錯時,您可以檢查類別的所有實例,其作法是在編輯器大綱、變數視圖、編譯單元或類別檔編輯器中,選取一個類別,然後從快速功能表呼叫所有實例...。這時蹦現對話框會顯示選取類別的所有實例。

在「變數」視圖中顯示參照

預設 VM 引數

如果您經常指定同樣的引數給特定的 VM,則可以在已安裝的 JRE 喜好設定頁面,配置預設的 VM 引數。 比起每採用一個啟動配置都要指定一次引數,這樣要方便得多。

有指定預設引數的 JRE 喜好設定頁面

在 main 中停止 您可以在「Java 應用程式」啟動配置中使用在 main 中停止,使得您的程式在除錯模式下執行時,將在 main 方法的第一行執行行中停止。

有選取「在 main 中停止」選項的 Main 標籤

條件式岔斷點 您可以使用岔斷點內容...對話框,或是「岔斷點」視圖中的詳細資料窗格,使用表示式來定義條件式岔斷點。 條件會控制岔斷點實際中止執行的時機。您可以指定是否僅在條件為 True 時, 或僅在條件值變更時,才想要岔斷點暫停執行。 岔斷點條件編輯器支援內容輔助。

岔斷點內容對話框或岔斷點詳細資料窗格中的岔斷點條件編輯器

寫入至主控台來進行除錯 您可以使用條件式岔斷點來列印至「主控台」視圖,以便在除錯時,避免在程式碼中插入 System.out.println() 陳述式。如果要執行這項作業,請使用當 'true' 則暫停選項來設定一個條件式岔斷點,以及設定一項一律為 false 的條件,例如:

System.out.println("Debug statement!"); return false;

停用岔斷點 如果您發現自己經常在同一位置新增和移除岔斷點,不妨考慮在不需要岔斷點時停用它,等到需要時再重新啟用。 您可以使用岔斷點快速功能表的停用岔斷點,或者在「岔斷點」視圖中,取消選取岔斷點。

您也可以使用「岔斷點」視圖工具列的跳過所有的岔斷點動作,暫時停用所有的岔斷點。 此舉可以讓除錯器,在維護目前啟用狀態時,跳過所有的岔斷點。

尺規快速功能表的「停用岔斷點」動作

變更變數值 在除錯器中暫停執行緒時,您可以在變數視圖中,變更 Java 基本元素和「字串」的值。 從變數的快速功能表選取變更變數值。 您也可以在「詳細資料」窗格中輸入新值來變更這個值,或利用快速功能表中的指派值動作(CTRL+S 按鍵連結)來變更這個值。

從詳細資料窗格變更變數值

浮動說明中的變數值 當執行緒暫停,當將游標放在 Java 編輯器中的某個變數上時,會以浮動說明方式來顯示變數的值。

編輯器中的變數值浮動說明

放到頁框 當逐步執行您的程式碼時, 您偶爾會逐步執行過多的副程序,或跳過原先要進入以進行副程序除錯的一行。 您不需重新啟動您的除錯階段作業,您可以使用放到頁框動作,來迅速地回到方法的開頭。 您可以選取對應於您想要重新啟動之 Java 方法的堆疊框,然後從「除錯」視圖工具列或堆疊框的快速功能表,選取放到頁框。 現行指示指標將重設為方法中第一個可執行的陳述式。 這個方法也適用於非頂層的堆疊框。

請注意,只有在利用 1.4 或更新版本的 VM,或 J9 VM 除錯時,才能使用「放到頁框」。 JVM 不見得都能從堆疊顯示您所要的頁框。 例如,要放到堆疊的最下方頁框,或是放到原始方法下的任何頁框,都是不太可能的事情。

快速程式碼取代 當利用 1.4 或更新版本的 VM,或 J9 VM 除錯時,除錯器支援「快速程式碼取代」。 這可讓您變更目前正在除錯的程式碼。請注意,根據某個特定 VM 所提供的支援而定,有的變更(例如新方法或是被刪除的方法、類別變數或是內部類別)是無法快速切換的。
進入選項與超鏈結除錯 Java 除錯器可讓您進入一系列鏈結的或巢狀的方法呼叫內的單一方法, 進行副程序除錯。僅選取要進入以進行副程序除錯的方法,然後從 Java 編輯器快速功能表選取進入選項進行副程序除錯。

這項特性也適用於非目前執行行。 請嘗試除錯到岔斷點,進入方法現行指令指標下面的幾行。

進入副程序選項

如果方法名稱中沒有脫字符號 (^),特性會進入選取的字行中之下一個方法。例如,當脫字符號是在這一行的開頭:
    assertTrue(fFull.size() == 100),
進入副程序選項就會進入 assertTrue(..) (不像進入副程序會進入 size())。

您也可以使用超鏈結導覽,來進入方法。您只需將游標放在您要進入的方法上,並使用 Ctrl+Alt+按一下,來進入該方法(而非按住 Ctrl 再點選,這會導覽至原始碼)。

使用「Ctrl+Alt+按一下」,進入方法超鏈結

主控台固定和鎖定 主控台所顯示的輸出,可以透過「主控台」視圖工具列中的固定主控台動作,鎖定至特定程序。 另外還有一個捲動鎖定動作,可以在附加新輸出時,使主控台不捲動。
建立監看項目 監看項目是表示式視圖中的表示式,當您除錯時,其值就會更新。您可以從 Java 編輯器建立監看項目,方法是選取表示式或變數,然後從快速功能表或最上層的執行功能表選取監看。
監控點 監控點就是每當存取或修改指定的欄位時暫停執行的岔斷點。 如果要設定監控點,請在「大綱」視圖選取一個欄位,再從快速功能表中選取切換監控點。 如果要配置監控點,請在岔斷點視圖中選取監控點,然後從它的快速功能表選取內容...。 這類岔斷點的最重要內容是存取和修改勾選框,因為它們控制岔斷點何時可以暫停執行。

「岔斷點內容」對話框

類別載入岔斷點 當在虛擬機器中載入指定的類別時,類別載入岔斷點會暫停執行。如果要設定類別載入岔斷點,請在「大綱」視圖選取一個類別,再從其快速功能表中選取切換類別載入岔斷點。您也可以使用執行 > 新增類別載入岔斷點... 功能表動作,來建立類別載入岔斷點。

載入指定的類別時,類別載入岔斷點會暫停執行

方法岔斷點 當進入或跳出特定方法時,方法岔斷點會暫停執行。如果要設定方法岔斷點,請在「大綱」視圖選取一個方法,再從其快速功能表中選取切換方法岔斷點。或者,按兩下編輯器尺規中的方法宣告行,或是使用執行 > 切換方法岔斷點功能表動作,在目前選取的方法中建立一個方法岔斷點。

依預設,只有在進入方法時,方法岔斷點才會暫停執行。您可以使用岔斷點的詳細資料窗格或岔斷點的內容對話框,將岔斷點配置成在跳出時暫停。方法岔斷點亦支援條件。

進入或跳出特定方法時,方法岔斷點會暫停執行

執行緒和監視器 Java 除錯器可選擇性地在除錯視圖中顯示監視器資訊。您可以使用「除錯」視圖下拉功能表中的顯示監視器動作, 來顯示哪些執行緒中在鎖定中,以及哪些執行緒在等待取得鎖定。處於死鎖的執行緒會以紅色呈現。

顯示死鎖循環的「除錯」視圖

逐行過濾器 逐行過濾器可以避免除錯器在進入程式碼進行副程序除錯時,在指定的類別和套件中暫停執行。 請利用 開啟「逐行過濾」喜好設定頁面 Java > 除錯 > 逐行過濾喜好設定頁面來建立逐行過濾器。 當您開啟使用逐行過濾器切換項目(位於除錯工具列和功能表)時,逐行過濾器即會套用到所有的步驟動作。在「除錯」視圖中,選取堆疊框的套件或宣告類型可以迅速地新增至過濾器清單,方法為從堆疊框的快速功能表選取過濾器類型或過濾器套件。
使用即時運算簿 如果您想要實驗 API 或測試新的演算法,使用 Java 即時運算簿頁面經常比建立新類別來得容易得多。即時運算簿頁面是程式碼隨機片段的儲存器,您可以隨時執行這些片段, 而不需環境定義。如果要建立即時運算簿頁面,請建立一個副檔名為 .jpage 的新檔案(或使用 開啟「新建即時運算簿」精靈 新建即時運算簿頁面精靈)。 請輸入任何要執行的程式碼,再選取它。 執行程式碼的方法有下列三種:
  • 執行選取的程式碼,將傳回的結果放在檢查蹦現畫面中
  • 執行選取的程式碼並將「字串」結果直接置於即時運算簿頁面中

    顯示結果的即時運算簿頁面

  • 執行選取的程式碼(並忽略任何傳回的結果)

這些動作位在工作台工具列中,也位在即時運算簿頁面的快速功能表中。

編輯
啟動
配置
按住 Ctrl 鍵並從執行或除錯下拉功能表進行選擇,將開啟相關聯的啟動配置以進行編輯。啟動配置也可以從與「除錯」視圖中任何項目相關聯的快速功能表開啟。
我的最愛啟動配置 啟動配置會按最近啟動的次序出現在「執行/除錯」下拉功能表中。 然而,有可能迫使某個啟動配置恆出現在下拉功能表的頂端, 方法為讓這個配置成為 '我的最愛'。您可以在適當的下拉功能表,使用組織我的最愛... 動作,來配置您最喜歡的啟動配置。
詳細資料格式製作程式 在變數和表示式視圖中,詳細資料窗格會顯示目前選取之變數的已展開表示法。 依預設,這個展開的表示法是在選取物件上呼叫 toString() 的結果,但您可以從變數的快速功能表中,選取新建詳細資料格式製作程式來建立一個將改用的自訂詳細資料格式製作程式。 所有同類型的物件都將使用這個詳細資料格式製作程式。您可以在 開啟「詳細資料格式製作程式」喜好設定頁面 Java > 除錯 > 明細格式製作程式喜好設定頁面中,檢視和編輯所有詳細資料格式製作程式。

「詳細資料格式製作程式」對話框

執行有編譯錯誤的程式碼 您可以執行和除錯並未清楚地編譯的程式碼。執行有和沒有編譯錯誤的程式碼之間的唯一差異, 就是如果執行一行有編譯錯誤的程式碼,將發生下列兩種情況之一:
  • 如果在 開啟「除錯」喜好設定頁面 Java > 除錯喜好設定頁面上設定了「發生編譯錯誤時,暫停執行」喜好設定,且您正在進行除錯,除錯階段作業將會暫停,如同遇到岔斷點一般。 請注意, 如果您的 VM 支援「快速程式碼取代」,您將可以修正編譯錯誤並回復除錯
  • 否則,執行將終止,並出現 '未解決編譯' 錯誤

有一點必須注意,只要您的執行路徑避開有編譯錯誤的程式碼行,您就可以如平常一般執行並除錯。

「變數」視圖中的自動折行 除錯器的變數和表示式視圖的詳細資料區域支援自動折行, 可從檢視下拉功能表取得它。

「變數」視圖下拉功能表中的自動折行動作

除錯器中的程式碼輔助 除了在 Java 編輯器中撰寫程式碼之外,程式碼輔助還可以在許多環境定義中使用:
  • 於輸入岔斷點條件時
  • 在變數 & 表示式視圖的詳細資料窗格
  • 於輸入詳細資料格式製作程式程式碼片段時
  • 於輸入邏輯結構程式碼片段時
  • 於即時運算簿頁面中輸入程式碼時
  • 在顯示視圖中
指令行詳細資料 您恆可以在執行或除錯模式中,看到用來啟動程式的確切指令行,方法為從程序或除錯目標的快速功能表選取內容,即使啟動已終止,也是可以。

指令行詳細資料

堆疊追蹤
超鏈結
主控台中會出現含超鏈結的 Java 堆疊追蹤。當您將滑鼠放在堆疊追蹤中的某一行時,指標會變成手狀。 按下滑鼠按鈕將開啟相關聯的 Java 程式檔, 並且會將游標定位在對應行中。如果您在堆疊追蹤頂端的異常狀況名稱上按一下滑鼠按鈕,就會建立一個異常狀況岔斷點。

具有超鏈結之「主控台」視圖中的堆疊追蹤

在 Java 視景中除錯 您可以配置執行/除錯 > 視圖管理喜好設定,於 Java 視景中進行除錯。請選取您要在其中除錯的視景。

「視圖管理」喜好設定頁面

確定「在觸及岔斷點時啟動除錯視圖」的喜好設定已開啟(透過最上層的執行/除錯喜好設定頁面)。

「執行/除錯」喜好設定頁面

您可以在執行/除錯 > 視景喜好設定頁面中停用視景切換提示。透過這些設定,當觸及岔斷點時,即會在 Java 視景中自動開啟「除錯」視圖。

視景喜好設定頁面

透過將「除錯」視圖放在視景的最上方,並將其高度重新調整成一個元素的大小,該視圖即可切換至瀏覽途徑呈現方式。如此可將視圖耗用的畫面空間量降至最低。

瀏覽途徑模式下的「除錯」視圖