格式製作程式

在 Java 編輯器中,於程式碼上按下 Ctrl+Shift+F,將它格式化。如果未設定選項,就會將整個程式碼格式化,否則,只會將選項格式化。本章段落會列出格式製作程式的使用提示。

請注意,您可以在 開啟「Java 格式製作程式」喜好設定頁面 Java 格式製作程式喜好設定頁面中,存取「Java 格式製作程式」喜好設定。

在區段內停用格式製作程式

您可以在程式碼的一或數個區段中,停用/啟用格式製作程式,如以下範例所示:

Java 格式製作程式範例。一些使用停用與啟用標籤的程式碼。

上方的片段使用預設標籤名稱,但是您可以在「Java 格式製作程式」喜好設定頁面中「關閉/開啟」標籤的標籤中變更它們。

將最外層方法呼叫折行

從 3.6 版起,現在 Java 格式製作程式將巢狀方法呼叫折行時,會嘗試讓最外層的方法呼叫先折行,以獲得較好的輸出。

以下是格式化程式碼範例,例如,格式製作程式會讓最外層訊息呼叫引數之間的字行折行,讓每一項巢狀方法呼叫各佔一行:

Java 格式製作程式範例。在簡式片段中,具有已格式化的巢狀方法呼叫。

新的喜好設定可讓您停用這項策略,一般而言,如果您想照以前的方式來將您的程式碼格式化,請取消勾選偏好讓外部表示式折行喜好設定,這項喜好設定可以在「Java 格式製作程式」喜好設定頁面的折行標籤中存取。

附註:目前這項新策略僅適用於巢狀方法呼叫,不過未來版本可能擴及至其他的巢狀表示式。

壓縮 Javadoc 與區塊註解

使用者可以減少多行已格式化註解的行數,如以下範例所示:

Java 格式製作程式範例。在簡式片段中,區塊與 Javadoc 註解已格式化,其字行比預設設定檔的字行少。

如果要啟動這項行為,請取消勾選各行中的 /* 與 */ 喜好設定,這項喜好設定可以在「Java 格式製作程式」喜好設定頁面的註解標籤中存取。

同一類型的喜好設定亦適用於 Javadoc 註解。

保留使用者換行

使用者可以藉由不結合程式碼或註解中的字行,來保留換行。

例如,在下列測試案例中,return 陳述式既有的折行:

格式化程式碼範例

當使用絕不結合字行喜好設定時,會由格式製作程式加以保留,因而會在格式化時產生以下輸出:

使用「絕不結合字行」的格式化程式碼

如果要啟動這項行為,請勾選絕不結合字行喜好設定,這項喜好設定可以在「Java 格式製作程式」喜好設定頁面的折行與註解標籤中存取。

相關概念

Java 編輯器
Java 開發工具 (JDT)

相關參照

編輯功能表
Java 編輯器喜好設定
格式製作程式喜好設定