Java 跨平台開發必讀：12 條避坑指南與最佳實踐

核心原則：100% Pure Java

僅使用 Java 核心 API；第三方庫必須同為 Pure Java，否則需連同 JVM 佈署。Visual J++ 等非標準工具產出的代碼不具備跨平台性。

編譯與代碼層面

1. 開啟所有編譯警告：盡早發現平台相關代碼（雖無警告不保證跨平台，有警告極大概率非跨平台）。
2. 拒絕過時/未文檔化方法：查閱 Javadoc，避免 @Deprecated 與未公開 API。
3. 慎用 System.exit()：會終止整個 JVM，影響同進程其他 Java 程式。正常退出用 destroy()（單一進程）或關閉所有非守護執行緒（多執行緒），異常退出才用 exit()。
4. 避免 Native 方法：優先用 Java 重寫；必須用時隔離為伺服器程式，以 CORBA/RMI 通訊。
5. 避免 Runtime.exec() 硬編碼命令：命令與參數平台相關（Windows notepad vs Linux vi），交由用戶配置。
6. 字元集統一用 ASCII：非所有平台支援 Unicode，中文軟件尤為關鍵。

平台相關常數與路徑

7. 不硬編碼平台常數：行分隔符、檔案分隔符、路徑分隔符。使用 System.getProperty()：
   • file.separator：Windows \ / Unix /
   • line.separator、path.separator
8. 網路程式避免 InetAddress.getHostName()：主機名格式平台差異大，改用 getAddress() 取得統一 IP 格式；代碼中全部用 IP 替代主機名。
9. 檔案路徑不硬編碼：不同平台檔名字元與長度限制不同，統一用 ASCII 命名並避免衝突。

GUI 與顯示適配

10. GUI 布局管理器：禁止硬編碼組件大小/位置，必須使用 LayoutManager（FlowLayout, BorderLayout, GridBagLayout 等）。
11. 動態獲取系統色彩與螢幕屬性：
    • java.awt.SystemColor：inactiveCaption、menu 等系統色彩。
    • Toolkit.getScreenResolution()：DPI。
    • Toolkit.getScreenSize()：螢幕尺寸。
    • Toolkit.loadSystemColors()：列出所有系統色彩。

總結

跨平台非自動實現，需從編譯警告、API 選擇、常數抽象、路徑處理、網路編碼、GUI 布局、顯示適配全方位把關。良好習慣養成，一次編譯、處處執行才能落地。