萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Linux 下 Java 應用中文顯示方塊(豆腐塊)完整解決方案

問題現象

Linux(Ubuntu 等)執行 Java Swing/JavaFX 應用程式時,UI 元件(按鈕、標籤、文字輸入框)中的中文字符顯示為方塊 □□□(俗稱「豆腐塊」),但檔案輸出、資料庫存儲均正常。原因在於 JDK 缺少中文字型回退機制。

根本原因

  • JDK 內建字型(Lucida Sans 等)不含中文字形。
  • 邏輯字型(SansSerif、Serif、Monospaced、Dialog、DialogInput)映射至實體字型時,找不到中文支援的回退字型。
  • 結果:英文顯示正常,中文 fallback 失敗 → 顯示缺字符號(方塊)。

解決方案:部署開源中文字型至 JRE 回退目錄

1. 取得中文字型檔

  • 推薦:文泉驛微米黑(WenQuanYi Micro Hei)、思源黑體(Source Han Sans CN)、Noto Sans CJK。
  • Ubuntu/Debian 安裝:sudo apt-get install fonts-wqy-microhei fonts-noto-cjk
  • 或下載單一 TTF 檔:WenQuanYi Micro Hei、Source Han Sans。

2. 部署至 JRE/JDK 字型回退目錄

# 確認 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 為準。

3. 重啟 Java 應用驗證

中文應正常顯示。若無效,檢查字型檔案權限(需 644)與檔名拼寫。

進階方案:fontconfig 配置(系統級,影響所有 Java 程式)

現代 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

Docker 容器環境特別處理

# 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 9+ 模組化系統注意事項

  • 模組 java.desktop 包含字型處理,確保未使用 --limit-modules 排除。
  • 可透過 -Djava.awt.fonts=/path/to/fonts 指定額外字型目錄(非標準屬性,視實作而定)。

總結

方法適用場景優點缺點
JRE fallback 目錄放字型舊版 JDK、獨立部署應用不依賴系統字型配置、隔離性好需每個 JRE 重複操作、升級 JRE 失效
fontconfig 用戶/系統配置現代 OpenJDK 9+、系統級統一管理一次配置所有 Java 受惠、支援字型替換規則豐富需理解 fontconfig XML 語法
安裝系統中文字型套件Docker、伺服器環境最簡單、套件管理器自動維護依賴發行版套件庫版本

推薦優先採用「安裝系統字型套件 + fontconfig 配置」組合,徹底解決中文顯示問題。

copyright © 萬盛學電腦網 all rights reserved