C/C++程式碼格式化美化工具

把緊湊的 C/C++ 程式碼整理成易讀版面

這個工具適合處理貼上的 C 或 C++ 程式片段，提供「格式化」與「壓縮」兩種文字重排方式。格式化會依程式區塊加入換行與縮排；壓縮則收緊多餘空白，方便快速查看較短的文字版本。結果仍是原始碼文字，不會執行或編譯程式。

格式化可設定每層縮排為 2、4 或 8 個空格，也可使用 Tab；大括號可選 K&R（左大括號接在宣告或控制敘述後）或 Allman（左大括號另起一行）。這些選項只決定版面呈現，不代表哪一種風格較正確，也不等於符合特定團隊規範。

格式化與壓縮會改動哪些文字

格式化模式會整理空白、換行、括號區塊與部分間距，並提供是否移除註解的選項；預設保留註解。壓縮模式會固定移除註解，並收緊大括號、括號、逗號與分號周圍的空白。畫面會顯示輸入與輸出的字元數、行數；壓縮模式另顯示字元數變化比例。

字元減少只代表輸出文字較短，不能據此推斷程式執行較快、編譯檔較小或網路傳輸量一定下降。此處的 C/C++ 排版也不是完整語法樹分析，並未提供欄寬、專案設定檔或 clang-format 樣式選擇。

貼上片段、調整選項並取回結果

1. 貼上 C 或 C++ 原始碼，或載入頁面範例作為操作示範。輸入區會顯示字元數與行數；清除按鈕可移除目前文字。

2. 選擇「格式化」或「壓縮」。格式化時再設定縮排寬度、空格或 Tab、大括號位置，以及是否移除註解。壓縮模式不提供保留註解的選項。

3. 查看輸出區的排版結果與統計。輸入或選項改變時，輸出也會跟著更新；若出現處理錯誤，先確認貼上的片段完整，尤其留意字串、註解與括號是否被截斷。

4. 確認內容後複製結果，或下載為純文字檔。下載檔名固定為 formatted.cpp；若要放回專案，請依原始檔案名稱與副檔名另行儲存。

例如把 int main(){return 0;} 貼入後，選擇 4 個空格及 K&R，可得到分行並縮排的函式內容。切換成 Allman 會改變左大括號的位置；這只是排版差異，仍須檢查程式實際文字。

格式結果的常見疑問

套用前先檢查差異並保留原始碼

此格式化器以自訂的詞法辨識與文字重排規則處理輸入，不是完整 C/C++ 解析器。巨集、條件編譯、模板、編譯器擴充語法、未完成的片段及特殊空白寫法都可能需要人工確認。格式化或壓縮後，請比較原文與輸出；涉及巨集或特殊語法時，特別檢查每個 token、字串、字元常值與前處理指令。

移除註解或壓縮可能刪掉有意義的說明文字，亦可能讓程式差異難以閱讀。不要直接覆寫唯一原檔；先保存副本，再使用專案指定的編譯器、測試與程式碼審查流程確認變更。版面整齊不代表程式正確或安全。