Linux(Ubuntu 等)執行 Java Swing/JavaFX 應用程式時,UI 元件(按鈕、標籤、文字輸入框)中的中文字符顯示為方塊 □□□(俗稱「豆腐塊」),但檔案輸出、資料庫存儲均正常。原因在於 JDK 缺少中文字型回退機制。
sudo apt-get install fonts-wqy-microhei fonts-noto-cjk# 確認 JRE 安裝路徑
java -XshowSettings:properties -version 2>&1 | grep java.home
# 輸出範例:java.home = /usr/lib/jvm/java-11-openjdk-amd64
# 建立 fallback 目錄並複製字型
sudo mkdir -p /usr/lib/jvm/java-11-openjdk-amd64/lib/fonts/fallback
sudo cp /usr/share/fonts/truetype/wqy/wqy-microhei.ttc /usr/lib/jvm/java-11-openjdk-amd64/lib/fonts/fallback/
# 或複製下載的 .ttf/.ttc 檔案
注意:路徑依 JDK 版本與安裝方式而異,請以實際 java.home 為準。
中文應正常顯示。若無效,檢查字型檔案權限(需 644)與檔名拼寫。
現代 OpenJDK 優先使用系統 fontconfig 尋找字型,而非內建 fallback 目錄。配置 fontconfig 更徹底:
mkdir -p ~/.config/fontconfig/conf.d
cat > ~/.config/fontconfig/conf.d/99-java-chinese.conf <<'EOF'
SansSerif
WenQuanYi Micro Hei
Noto Sans CJK SC
DejaVu Sans
Serif
Noto Serif CJK SC
WenQuanYi Micro Hei
DejaVu Serif
Monospaced
Noto Sans Mono CJK SC
WenQuanYi Micro Hei Mono
DejaVu Sans Mono
EOF
# 更新字型快取
fc-cache -fv
fc-match SansSerif
fc-match -a SansSerif | head -10
# Dockerfile 片段
FROM openjdk:11-jre-slim
RUN apt-get update && apt-get install -y --no-install-recommends \
fonts-wqy-microhei fonts-noto-cjk \
&& rm -rf /var/lib/apt/lists/*
# 設定語系
ENV LANG=zh_TW.UTF-8
ENV LC_ALL=zh_TW.UTF-8
java.desktop 包含字型處理,確保未使用 --limit-modules 排除。-Djava.awt.fonts=/path/to/fonts 指定額外字型目錄(非標準屬性,視實作而定)。| 方法 | 適用場景 | 優點 | 缺點 |
|---|---|---|---|
| JRE fallback 目錄放字型 | 舊版 JDK、獨立部署應用 | 不依賴系統字型配置、隔離性好 | 需每個 JRE 重複操作、升級 JRE 失效 |
| fontconfig 用戶/系統配置 | 現代 OpenJDK 9+、系統級統一管理 | 一次配置所有 Java 受惠、支援字型替換規則豐富 | 需理解 fontconfig XML 語法 |
| 安裝系統中文字型套件 | Docker、伺服器環境 | 最簡單、套件管理器自動維護 | 依賴發行版套件庫版本 |
推薦優先採用「安裝系統字型套件 + fontconfig 配置」組合,徹底解決中文顯示問題。