萬盛學電腦網

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

Linux 解決 Java/Swing 應用 (NetBeans/IntelliJ) 中文顯示方框/亂碼問題

問題根因

JVM 依賴邏輯字體映射:fontconfig → 實體字體檔。缺少中文字體 (如 **文泉驛微米黑、思源黑體、Noto Sans CJK**) 時,Swing 元件無法渲染中文,顯示方框 (□) 或亂碼。

解決方案:安裝中文字體並刷新快取

1. 安裝開源中文字體 (推薦)


# 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

2. 手動部署字體至 JVM 目錄 (針對特定 JDK/JRE)


# 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 應用驗證

3. 字體配置檔優化 (/etc/fonts/local.conf 或 ~/.config/fontconfig/fonts.conf)





  
  
    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
    
  

IDE 專屬配置

NetBeans


# netbeans.conf (安裝目錄/etc/netbeans.conf)
netbeans_default_options="--fontsize 14 --laf Nimbus -J-Dawt.useSystemAAFontSettings=lcd -J-Dswing.aatext=true"

IntelliJ IDEA / Android Studio


# 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


# 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

Docker 容器中解決中文顯示


# 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
copyright © 萬盛學電腦網 all rights reserved