C#程式碼格式化美化工具

整理 C# 程式碼的縮排與括號

這項工具可將貼上的 C# 程式碼重新排版，或切換到壓縮模式收緊空白。美化時可設定每層縮排為 2、4、8 個空格或 Tab，並選擇 Allman（左大括號另起一行）或 K&R（左大括號接在宣告後）括號風格。結果區會顯示字元數與行數；壓縮時另顯示依輸入、輸出字元長度計算的變化百分比，結果可複製或下載。

這是依文字中的括號、分號及部分字串、註解標記整理版面的工具，不是完整 C# 編譯器或語法解析器。它不會執行程式、檢查型別，也不會讀取專案的格式設定。因此，排版整齊不代表程式可編譯或執行結果正確。

為何字串與空白需要特別留意

C# 的空白、註解、前置處理指示詞和字串各有語言規則。特別是多行原始字串，換行和結尾分隔符前的縮排會影響字串值；單純摺疊程式碼空白的整理器未必能正確保留每種新語法的意義。此工具的文字處理方式不保證涵蓋所有 C# 版本和語法組合，請把結果視為待檢查的排版稿。

壓縮模式會移除註解，並收緊標點與運算子附近的空白；其百分比只表示字元長度變化，不代表執行檔縮小、傳輸效能提升或語意等價。

從貼上到取回結果

1. 輸入要整理的片段

   貼上 C# 程式碼，或載入頁面提供的範例。輸入與輸出分開顯示，可先保留原文作為對照。

2. 選擇處理模式

   美化模式可挑選縮排寬度、空格或 Tab，以及 Allman 或 K&R 括號位置。若確定不需要註解，可在美化模式開啟移除註解；壓縮模式則會直接移除註解。

3. 檢查內容差異

   比對輸入和輸出，尤其檢查字串、多行內容、插值、註解、前置處理指示詞及括號層次。不要只憑外觀判定內容完全相同。

4. 複製或下載

   確認結果符合用途後再複製或下載。用於專案前，保留原檔並在可信任的開發環境中執行建置或測試。

縮排寬度是每層的空格數；Tab 則以定位字元表示縮排。Allman 與 K&R 只控制左大括號的位置，兩者不會套用你專案的其他命名或空白慣例。

使用前常見疑問

請保留原始碼並自行驗證

格式化和壓縮都可能改變程式文字；尤其壓縮會刪除註解，格式化也不承諾維持每一種 C# 語法的原意。不要直接以輸出取代唯一原檔。使用前應比較差異，對重要程式碼在專案中建置、測試，並以團隊採用的格式化工具作最後確認。

Microsoft 的 C# 語言規格說明字串、空白、註解和前置處理指示詞各自具有詞法規則；多行原始字串的內容可能包含有意義的換行與縮排。若需專案層級格式化，Microsoft 文件所述的 dotnet format 可依專案或方案及 .editorconfig 設定工作，與此處的片段排版用途不同。