追求代碼質量：馴服復雜冗長代碼的度量與工具實戰

面對龐大方法與蔓延的類，優秀開發者本能地感到畏懼——這不僅難以測試維護，更意味著更高錯誤率。圈複雜度是代碼惡化的先兆，上期介紹了 Extract Method 重構降低方法複雜度。但圈複雜度並非唯一指標：類長度、方法長度、內部類耦合同樣關鍵，它們相互關聯，共同決定代碼健康度。本文解釋為何這些指標重要，並演示如何用 PMD 與 JavaNCSS 追蹤它們。

代碼過長的危害

人類工作記憶容量約 7±2 塊信息。過長方法包含過多邏輯塊，讓人難以掌握整體意圖，成為缺陷溫床；同理，過長類承擔過多職責，違反單一職責原則。經驗法則：方法超 50–100 行、類超 500–1000 行即屬「過長」，具體閾值視團隊而定。

內部類耦合：輸出與輸入耦合

• 輸出耦合（Efferent Coupling）：導入外部類超 80 個（不含 JDK），修改被導入類可能波及本類；若導入具體實現而非接口，風險更大。使用 .* 通配符導入整包易誤導，需關注唯一類型數。
• 輸入耦合（Afferent Coupling）：擁有大量 public 方法的類（如 Facade、工具類）成為中心節點，任何變更可能波及無關模組，形成反向脆弱性。

復雜性指標的相關性

長方法常伴隨高圈複雜度；大量導入的類通常擁有眾多唯一類型、龐大體積、長方法，最終導致高圈複雜度。這些指標相互強化，形成「大泥球」反模式。

工具實戰：PMD 規則定制與 JavaNCSS 統計

PMD：基於規則的靜態分析

PMD 內建 ~200 條規則，針對方法長度（ExcessiveMethodLength）、類長度（ExcessiveClassLength）、唯一類型（CouplingBetweenObjects）、導入數（ExcessiveImports）均有對應規則，且可通過規則集文件定制閾值：

<rule ref="rulesets/codesize.xml/ExcessiveMethodLength">
  <properties>
    <property name="minimum" value="50"/>  <!-- 默認 100，改為 50 -->
  </properties>
</rule>

Ant 調用時指定 rulesetfiles 指向定制文件，生成 XML/HTML 報告，直觀展示違規方法。

JavaNCSS：全量度量與上下文視角

PMD 僅報告違規文件，視野受限。JavaNCSS 掃描所有文件，報告類大小、方法大小、方法數量，無論是否超標，提供完整上下文分佈圖，幫助團隊掌握整體代碼健康度。

遺留代碼治理建議

綠地開發只是生命週期微小片段，多數時候我們在與遺留代碼博弈。首步：用類/方法長度、耦合指標建立基線；次步：引入 PMD、JavaNCSS 持續監控；再步：針對熱點重構。持續監控復雜度指標，才能在擴展維護中做出明智決策、降低風險。