Java程式碼格式化美化工具

把緊湊的 Java 原始碼整理成可讀版面

這個工具提供「格式化」與「壓縮」兩種文字整理方式。格式化會依大括號切分區塊並重新排列縮排與換行，可選每層 2、4 或 8 個空格，也可改用 Tab；大括號可選 K&R（左大括號接在宣告或控制列後）或 Allman（左大括號另起一行）。預設為 4 個空格、空格縮排及 K&R。格式化模式另有移除註解的選項，預設關閉。

壓縮模式會收緊空白與常見運算符周圍的間距，並移除註解；它適合快速查看較短的文字呈現，不代表程式碼經過最佳化或驗證。這裡的「格式」指閱讀版面，不是編譯結果。

格式選項不是完整團隊規範

Java 的空白、註解、識別字及字串等都屬於詞法結構。某些空白負責分開詞法單元，不能把所有空白都當成可任意刪除的裝飾。工具提供的是少數縮排與大括號選項，不會套用完整風格指南，也不會依行寬重新折行或整理匯入項目。Google Java Style Guide 可作為一種風格參考；例如其規範採 K&R 大括號與兩空格縮排，但專案既有規範應優先。

依專案習慣設定並整理程式碼

1. 貼上 Java 程式碼

   在輸入區貼上要整理的原始碼，也可載入頁面內建範例。結果會隨輸入及選項即時更新。

2. 選擇整理模式與版面

   要展開縮排時選「格式化」，再挑選 2、4 或 8 個空格、Tab，以及 K&R 或 Allman 大括號。若不需要保留註解，可開啟移除註解。要收緊文字則選「壓縮」；此模式會移除註解。

3. 檢查、複製或下載

   對照原文查看字串、文字區塊、註解、運算子和巢狀區塊，再複製結果或下載為文字檔。若要替換專案檔案，先比對差異並在原本的開發環境檢查。

例如 class Hi{void greet(){say("hi");}} 使用預設格式化後，會呈現為每層四個空格與 K&R 大括號的多行版面。這個示例只展示排版效果，不表示程式已通過編譯。

使用時常見的判斷

覆寫前請比對程式碼差異

格式化及壓縮都會改動文字空白與排列；移除註解或壓縮尤其會改變可見內容。簡易文字整理無法保證所有 Java 語法結構與邊界情況都處理正確。處理含有重要註解、字串、文字區塊或新語法的程式碼時，請仔細檢查前後差異；不要把輸出視為語法檢查或語義等價證明。正式採用前請保留原始版本，並使用專案採用的編譯器、測試與格式規則確認。