Java 原始碼換行規範：提升可讀性與團隊協作的關鍵細節

良好的程式碼排版不影響編譯，卻決定維護成本。本文歸納 Java 原始碼換行的四大核心技巧與變數宣告建議，助團隊建立統一風格，降低認知負擔。

基本原則

• 單行長度建議 ≤ 70 字元，上限 80 字元
• 超過長度必須換行，且需在「恰當位置」斷行
• 使用 Tab 縮排（預設 8 格），避免空格數不一致

四大換行技巧

技巧一：高層優先於低層

依運算子優先序斷行，優先在低優先序運算子前換行。

// 佳：在 + 號（低優先序）前換行
int result = a * (b + c + d - e)
           + 8 * f;

// 避免：在 * 號（高優先序）前換行
int result = a * (b + c + d - e) +
           8 * f;

技巧二：運算子前換行、逗號後換行

• 二元運算子：在運算子「前」換行，下一行對齊同層運算元
• 參數列舉：在逗號「後」換行，保持「參數、逗號」配對視覺

// 方法呼叫多參數換行範例
doSomething(param1,
            param2, param3,
            param4);

技巧三：同層級左對齊

換行後的新行，與上一行同層級的起始位置左對齊，形成清晰視覺階層。

if (condition1
    && condition2
    || condition3) {
    doIt();
}

技巧四：變數宣告位置與粒度

• 區塊開頭（{ 之後）集中宣告，避免散落在使用點附近
• 每行僅宣告一個變數，便於加註解、閱讀型別
• 避免重複宣告同名變數造成遮蔽

// 推薦
private int userId;
private String userName;
private Date createTime;

// 避免
private int userId, userCount; // 難加註解、型別不明顯

團隊落地建議

1. 專案啟動時制定《編碼規範》，納入 Code Review 檢核項目
2. IDE 匯入共用 Formatter 設定（Eclipse/IntelliJ 可匯出 .xml）
3. CI 流程整合 Checkstyle/SpotBugs 自動檢測
4. 新人入職必讀、老手定期複習

程式碼主要給人看，順便給機器跑。統一的換行規範，是專業工程師對同事、對未來的自己最基本的尊重。