編寫跨平台 Java 程序完全指南：12 大避坑清單

核心原則：100% Pure Java

• 僅使用 Java 核心 API（java.*, javax.*）
• 第三方庫必須同樣純 Java 實現，無 JNI 本地代碼
• 避免 Visual J++ 等非標準擴展

12 項跨平台檢查清單

1. 編譯警告全開：javac -Xlint 或 IDE 設置，盡早發現平台相關代碼
2. 拒絕過時/隱藏 API：不使用 @Deprecated 方法、sun.*、com.sun.* 內部類
3. 慎用 System.exit()：會殺死整個 JVM，多應用共存環境災難性。優先 window.dispose()、線程結束、System.exit() 僅作異常退出兜底
4. 消除本地方法依賴：JNI 破壞跨平台。改用純 Java 實現、進程間通訊 (Socket/HTTP)、或 CORBA/gRPC 服務化
5. Runtime.exec() 參數外部化：命令本身跨平台，但參數強依賴 OS（notepad.exe vs vi）。配置文件注入命令模板
6. 字符編碼統一 UTF-8：源文件、文件 I/O、網絡傳輸、控制台、日誌、數據庫連接全鏈路 UTF-8。避免平台默認編碼（Windows GBK、Linux UTF-8）
7. 路徑分隔符動態獲取：

   String sep = File.separator;           // \ 或 /
   String pathSep = File.pathSeparator;   // ; 或 :
   String lineSep = System.lineSeparator(); // \r\n 或 \n (Java 7+)
   

8. 網絡編程用 IP 而非主機名：InetAddress.getByName() 解析後存儲 IP，避免主機名格式差異
9. 文件路徑絕不硬編碼：用戶家目錄 System.getProperty("user.home")、臨時目錄 java.io.tmpdir、項目相對路徑
10. GUI 佈局管理器而非絕對座標：BorderLayout/GridBagLayout/MigLayout 自適應 DPI、字體、語言長度差異
11. 動態獲取屏幕/顏色屬性：

    Toolkit tk = Toolkit.getDefaultToolkit();
    Dimension screen = tk.getScreenSize();
    int dpi = tk.getScreenResolution();
    Color bg = SystemColor.window; // 系統默認窗口背景色
    

12. 測試矩陣覆蓋：CI 流水線強制在 Windows/Linux/macOS、x86/ARM、JDK LTS 版本上運行測試

驗證清單

• [ ] 无 sun.*/com.sun.* 引用
• [ ] 无硬編碼路徑、分隔符、編碼
• [ ] 无 System.exit() 正常流程調用
• [ ] 无 JNI/本地庫加載
• [ ] GUI 無 setBounds()/setLocation() 絕對座標
• [ ] 多平台 CI 綠燈