Java 條件編譯實戰：利用編譯器優化實現零開銷調試代碼

C/C++ 通過預處理器（#ifdef/#endif）實現條件編譯，Java 無預處理機制，但編譯器對 final 常量折疊與死代碼消除的優化，提供了等效甚至更優雅的方案。

核心原理

Java 編譯器（javac）在編譯期會進行常量傳播與死代碼消除：

• if (false) { ... } 塊不生成字節碼。
• final boolean DEBUG = false; → if (DEBUG) 同樣被優化掉。

編譯前 417 字節，加 if(false) 後僅 255 字節；反編譯發現主方法體為空。

三種實現層次

1. 硬編碼開關（最簡單）

public class Hello {
    public static void main(String[] args) {
        if (false) { // 改 true 開啟
            System.out.println("Debug: 進入主流程");
        }
        System.out.println("Hello, world!");
    }
}

2. final 常量控制（可維護）

public class Hello {
    private static final boolean DEBUG = true; // 單點修改
    public static void main(String[] args) {
        if (DEBUG) System.out.println("Debug: 參數=" + args.length);
        System.out.println("Hello, world!");
    }
}

3. 專用配置類（企業級）

public final class DebugConfig {
    public static final boolean BLUETOOTH_DEBUG = false;
    public static final boolean NETWORK_DEBUG = true;
    public static final boolean DB_SQL_LOG = false;
    private DebugConfig() {} // 防實例化
}

// 業務代碼
if (DebugConfig.NETWORK_DEBUG) {
    log.debug("發送封包: {}", packet);
}

優勢：集中管理、語義清晰、IDE 重構安全、編譯期零開銷。

進階：構建時動態控制

配合 Maven/Gradle Profile，在構建階段注入不同常量值：

<!-- pom.xml -->
<profiles>
  <profile>
    <id>dev</id>
    <properties><debug.flag>true</debug.flag></properties>
  </profile>
  <profile>
    <id>prod</id>
    <properties><debug.flag>false</debug.flag></properties>
  </profile>
</profiles>

// 使用 maven-resources-plugin 過濾資源文件或生成 DebugConfig.java

對比總結

注意：僅適用於 final static boolean/int/String 等編譯期常量；非常量變量、方法返回值、系統屬性 不會 觸發編譯期死代碼消除。