Perl程式碼格式化美化工具

快速整理 Perl 排版，先看清處理範圍

把 Perl 原始碼貼入後，可選擇「格式化」或「壓縮」，查看重新整理的文字結果。格式化可調整縮排為 2、4、8 個空格或 Tab，並選擇 K&R（左大括號接在同一行）或 Allman（左大括號另起一行）風格；也可選擇移除註解。壓縮模式會合併排版空白，並一律移除行註解與 POD 文件。結果可複製，或下載為文字檔。
這是以文字規則整理版面的輕量工具，不是 Perl 解析器、編譯器或語法檢查器。Perl 官方語法文件指出空白多半用來分隔詞法單元，但這不代表任何空白都能安全改寫；請依程式內容檢查輸出。

格式化與壓縮的差別

格式化保留可見的程式結構並依所選縮排與大括號風格重新排版，適合讓短小片段更容易閱讀。壓縮則著重合併空格、換行等排版空白，輸出可能更緊湊；畫面顯示的字元變化比例只描述文字長度差異，不能代表程式效能或結果正確。兩種模式都是產生供你檢查的文字副本，不會執行程式或修復錯誤。

大括號、引號與空白為何要複核

Perl 的大括號可能表示程式區塊，也可能出現在雜湊參照等運算式中；引號、正規表示式和特殊語法亦有各自規則。這個工具使用啟發式方式判斷部分結構，並非完整語法分析，因此複雜表達式的換行或空格可能不符合預期。尤其 here-document 的正文與終止標記具有特定規則，請逐行比對，不要只看縮排是否整齊。

選擇模式、調整版面，再檢查差異

1. 貼上 Perl 原始碼

   可直接輸入或貼上片段，也能載入頁面範例熟悉輸入與結果欄。處理正式程式前，先在自己的編輯器保留原始檔。

2. 設定整理方式

   選「格式化」時，依專案慣例設定空格數或 Tab，以及 K&R 或 Allman 大括號風格。要保留說明時，確認沒有啟用移除註解。選「壓縮」時，請注意此模式會移除註解與 POD。

3. 逐段核對輸出

   檢查變更前後的大括號、分號、引號、正規表示式、here-document 和註解位置。格式化或壓縮後的字元數只是排版結果的統計，不是語法檢查結果。

4. 複製或下載副本

   確認內容符合預期後再複製結果，或下載為 formatted.pl 文字檔；再於專案採用的 Perl 環境執行語法檢查與既有測試。

使用前常見疑問

正式採用前請保留原檔並驗證

啟發式整理可能無法正確辨識所有 Perl 語法。here-document 的終止標記及正文縮排可能影響內容；引號、正規表示式、POD 與巢狀大括號也應特別複核。移除註解會刪除說明文字，壓縮模式則固定移除註解與 POD。
請勿以輸出取代唯一原始檔。將結果放回自己的開發環境後，檢查差異、執行 Perl 語法檢查及專案測試；若程式涉及敏感或正式環境，應使用團隊核准的工具鏈與審查流程。