三步構建 Java 代碼質量遞增改善機制：基於 Ant + Cobertura + XSLT

核心思想：可測量、可視化、遞增式提升

參考 Google Peter Norvig 觀點：「若覺得不需要單測，寫下理由後扔掉，繼續測試。」關鍵在於如何驗證測試充分性 —— 引入代碼覆蓋率工具，建立增量門檻，每次建構必須超越上次質量基線。

步驟一：引入 Cobertura 覆蓋率檢查

<!-- build.xml 片段 -->
<taskdef resource="cobertura.tasks" classpathref="cobertura.classpath"/>

<target name="cobertura-check">
    <cobertura-instrument todir="${instrumented.dir}">
        <fileset dir="${build.classes}"><include name="**/*.class"/></fileset>
    </cobertura-instrument>
    
    <junit fork="yes" forkmode="once">
        <classpath><pathelement location="${instrumented.dir}"/></classpath>
        <batchtest><fileset dir="${test.classes}" includes="**/*Test.class"/></batchtest>
    </junit>
    
    <cobertura-report format="xml" destdir="${report.dir}" />
    
    <!-- 硬性門檻：行覆蓋率 ≥ 80% -->
    <cobertura-check branchrate="70" linerate="80" totalbranchrate="70" totallinerate="80" haltOnFailure="true" />
</target>

步驟二：動態基線 —— 以「上次覆蓋率」為本次門檻

避免硬編碼 80% 導致存量專案無法起步。實現邏輯：

1. Cobertura 產生 coverage.xml。
2. XSLT 轉換提取 line-rate，轉整數百分比寫入 coverage.properties。
   

   <xsl:template match="/coverage">
       total.line-rate=<xsl:value-of select="floor(@line-rate*100)"/>
   </xsl:template>
   

3. Ant 讀取屬性 <property file="coverage.properties"/>。
4. 下次建構門檻設為 ${total.line-rate} (或 +1%)。
   

   <cobertura-check totallinerate="${total.line-rate}" haltOnFailure="true"/>
   

效果：每次提交必須提升或持平覆蓋率，質量單調遞增，無倒退。

步驟三：趨勢追蹤與可視化

<target name="track-coverage">
    <echo message="Coverage baseline updated: ${total.line-rate}%"/>
    <echo file="coverage.history" append="true">${DSTAMP} ${TSTAMP} ${total.line-rate}%</echo>
</target>

• 歷史檔 coverage.history 可繪製趨勢圖 (Excel/Grafana/Confluence 圖表巨集)。
• 團隊每日立會展示覆蓋率走勢，質量具象化。

完整建構流程整合

<target name="build" depends="compile, test, cobertura-report, cobertura-check, track-coverage" />

關鍵點：cobertura-check 通過後才生成新報告，確保歷史基線始終對應「通過門檻的版本」。

擴展：將策略應用於其他質量指標

• SpotBugs/PMD：XML 報告 -> XSLT 提取 Bug 數量/嚴重級別 -> 遞增門檻 (新增 Bug = 0)。
• Checkstyle：違規計數遞減。
• 圈複雜度：平均/最大值遞減。

統一模式：工具產出 XML -> XSLT 過濾關鍵指標 -> Ant 屬性化 -> 遞增門檻 -> 趨勢記錄。

實戰成果

「一週內代碼質量提升 30%+，開發者從抗拒測試轉為以通過門檻為榮，質量文化自發形成。」