Java 專案開發命名規範最佳實踐指南

核心命名原則

Java 專案開發中，統一且語義清晰的命名規範是程式碼可讀性、可維護性的基石。核心原則：**優先使用英文單字，避免漢語拼音；採用駝峰命名法；名稱須表達業務含義。**

各層級命名規範

1. 套件命名

• **規則**：公司網域反轉，全小寫
• **範例**：com.bjpowernode.test（對應 www.bjpowernode.com）
• **類別全名**：com.bjpowernode.Test.java
• **預設套件**：未宣告 package 時屬於 default package，實務上應避免使用

2. 類別命名

• **規則**：帕斯卡命名法 — 首字母大寫，多單字每字首大寫，無連接符
• **範例**：ConnectionFactory, UserServiceImpl, OrderController
• **建議**：名詞或名詞短語，表達職責單一的領域概念

3. 方法命名

• **規則**：駝峰命名法 — 首單字小寫，後續單字首字母大寫，無連接符
• **範例**：addPerson, getUserById, calculateTotalAmount
• **建議**：動詞或動詞短語，清晰表達行為意圖

4. 變數/屬性命名

• **規則**：同方法命名（駝峰法）
• **範例**：ageOfPerson, userName, orderList
• **布林變數**：建議用 is/has/can 開頭，如 isValid, hasPermission, fileExists

5. 常數命名

• **規則**：全大寫，單字間用底線分隔
• **範例**：public static final int MAX_RETRY_COUNT = 3;
• **建議**：通常搭配 static final，語義完整表達業務常量

進階命名建議與反模式

變數命名最佳實踐

常數命名補充規範

• 程式碼中除 0, 1 外，避免出現魔術數字
• 常數集中定義於類別開頭或更大作用域
• 多單字常數用底線分隔：NUM_DAYS_IN_WEEK, MAX_CONNECTION_POOL_SIZE

作用域與資料類型選擇

• **最小作用域原則**：變數宣告越接近使用位置越好，減少副作用與資源佔用
• **最佳資料類型**：選擇恰好滿足需求的類型，降低記憶體佔用、提升效能、減少型別轉換錯誤風險
• 編譯器不會對隱性型別轉換報錯，只會截斷或溢出，此類 Bug 極難排查

總結

良好的命名規範是團隊協作的溝通語言。建議專案啟動時制定命名標準文件，配合 IDE 格式化模板與靜態分析工具（如 Checkstyle、SonarQube）強制執行。命名即設計，名稱若難以取得簡潔明確，往往暗示著類別或方法職責不清，需重新審視設計。