JVM 依賴邏輯字體映射:fontconfig → 實體字體檔。缺少中文字體 (如 **文泉驛微米黑、思源黑體、Noto Sans CJK**) 時,Swing 元件無法渲染中文,顯示方框 (□) 或亂碼。
# CentOS/RHEL/Fedora
yum install -y google-noto-sans-cjk-fonts wqy-zenhei-fonts wqy-microhei-fonts
# Ubuntu/Debian
apt update && apt install -y fonts-noto-cjk fonts-wqy-zenhei fonts-wqy-microhei
# Arch/Manjaro
pacman -S noto-fonts-cjk wqy-zenhei wqy-microhei
# 1. 確認 JRE 路徑
update-alternatives --config java
# 輸出範例: /usr/java/jdk1.8.0_45/jre
# 2. 建立 fallback 字體目錄
mkdir -p /usr/java/jdk1.8.0_45/jre/lib/fonts/fallback
# 3. 複製字體檔 (以文泉驛微米黑為例)
cp /usr/share/fonts/wqy-microhei/wqy-microhei.ttc /usr/java/jdk1.8.0_45/jre/lib/fonts/fallback/
# 4. 刷新字體快取
fc-cache -fv
# 5. 重啟 Java 應用驗證
sans-serif
Noto Sans CJK TC
WenQuanYi Micro Hei
DejaVu Sans
monospace
Noto Sans Mono CJK TC
WenQuanYi Micro Hei Mono
DejaVu Sans Mono
serif
Noto Serif CJK TC
WenQuanYi Zen Hei
DejaVu Serif
# netbeans.conf (安裝目錄/etc/netbeans.conf)
netbeans_default_options="--fontsize 14 --laf Nimbus -J-Dawt.useSystemAAFontSettings=lcd -J-Dswing.aatext=true"
# idea.vmoptions / studio.vmoptions (Help → Edit Custom VM Options)
-Dawt.useSystemAAFontSettings=lcd
-Dswing.aatext=true
-Dsun.java2d.uiScale=1.0
# 設定編輯器字體: Settings → Editor → Font → 主字體選 Noto Sans CJK SC / 文泉驛微米黑
# eclipse.ini
-Dorg.eclipse.swt.internal.gtk.cairoGraphics=false
-Dawt.useSystemAAFontSettings=lcd
# Preferences → General → Appearance → Colors and Fonts → Basic → Text Font 選中文字體
# 列出 JVM 可用字體
java -cp /usr/java/jdk1.8.0_45/jre/lib/rt.jar sun.font.FontManager 2>/dev/null | grep -i -E 'noto|wenquanyi|wqy'
# 或編寫測試程式
cat > FontTest.java <<'EOF'
import java.awt.*;
public class FontTest {
public static void main(String[] args) {
GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
for (String fn : ge.getAvailableFontFamilyNames()) {
if (fn.matches(".*[\\u4e00-\\u9fa5].*|Noto|WenQuan|Wqy|Micro|Zen")) {
System.out.println(fn);
}
}
}
}
EOF
javac FontTest.java && java FontTest
# Dockerfile
FROM openjdk:8-jdk
RUN apt-get update && apt-get install -y fonts-noto-cjk fonts-wqy-zenhei && fc-cache -fv
ENV LANG=C.UTF-8
ENV LANGUAGE=C.UTF-8
ENV LC_ALL=C.UTF-8
| 誤區 | 正確觀念 |
|---|---|
| 只安裝字體不刷新快取 | 必須執行 fc-cache -fv 讓 fontconfig 掃描新字體 |
| 以為 JDK 內建中文字體 | JDK 僅內建 Lucida 等西文字體,**不包含中文字體** |
| 修改系統語系即可 | LANG=zh_TW.UTF-8 僅影響區域設定,**不解決字體缺失** |
| 只在 ~/.fonts 放字體 | 系統級 JVM 讀取系統字體目錄,建議安裝至系統路徑或 JVM lib/fonts/fallback |