本文提供在 Linux 系統 (以 Ubuntu/Debian、CentOS/RHEL/Fedora 為例) 上安裝 **JDK 17/21 LTS** 並配置 **Eclipse IDE 2024+** 的標準化、可維護流程。摒棄舊版手動解壓配置環境變數的繁瑣易錯方式,採用**套件管理器安裝 JDK**、**SDKMAN! 管理多版本 JDK**、**官方安裝器安裝 Eclipse**,確保系統整合度、易更新性與專案相容性。
SDKMAN! 是 JVM 生態的標準版本管理工具,支援安裝、切換、管理多個 JDK (Oracle JDK, OpenJDK, Temurin, GraalVM, Zulu 等)、Maven、Gradle 等工具。
# 1. 安裝 SDKMAN!
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
# 2. 列出可用的 LTS 版本 (推薦 Temurin 或 Oracle JDK)
sdk list java | grep -E "17|21" | grep -E "tem|oracle"
# 3. 安裝推薦的 LTS 版本 (以 Temurin 21 為例)
sdk install java 21.0.2-tem
# 4. 設為預設版本 (自動配置 JAVA_HOME 與 PATH)
sdk default java 21.0.2-tem
# 5. 驗證
java -version
echo $JAVA_HOME
優勢:用戶級安裝、不污染系統、輕鬆切換版本 (`sdk use java 17.0.10-tem`)、專案級 `.sdkmanrc` 自動切換、自動配置環境變數。
| 發行版 | 命令 (OpenJDK 21 LTS) | 備註 |
|---|---|---|
| Ubuntu / Debian | sudo apt update && sudo apt install openjdk-21-jdk | 預設安裝至 /usr/lib/jvm/ |
| CentOS / RHEL / Fedora | sudo dnf install java-21-openjdk-devel | 包含開發工具 (javac, jar 等) |
| Arch Linux | sudo pacman -S jdk21-openjdk |
安裝後,通常已自動配置 /etc/profile.d/jdk.sh 設定 JAVA_HOME 與 PATH。執行 source /etc/profile 或重新登入生效。
.tar.gz 壓縮包。sudo tar -xzf OpenJDK21U-jdk_x64_linux_hotspot_21.0.2_13.tar.gz -C /usr/lib/jvm//etc/profile.d/jdk.sh 或 ~/.bashrc):export JAVA_HOME=/usr/lib/jvm/jdk-21.0.2
export PATH=$JAVA_HOME/bin:$PATH
source /etc/profile.d/jdk.sh 生效,java -version 驗證。eclipse-inst-jre-linux64.tar.gz)。tar -xzf eclipse-inst-jre-linux64.tar.gzcd eclipse-installer && ./eclipse-inst~/opt/eclipse/ 或 /opt/eclipse/ 需 root)、JDK 路徑 (自動檢測或指定 SDKMAN! 路徑 ~/.sdkman/candidates/java/current)。~/.local/share/applications/eclipse.desktop。eclipse-java-2024-03-R-linux-gtk-x86_64.tar.gz)。tar -xzf eclipse-java-2024-03-R-linux-gtk-x86_64.tar.gz -C ~/opt/~/opt/eclipse/)~/.local/share/applications/eclipse.desktop):[Desktop Entry]
Name=Eclipse IDE
Comment=Eclipse Integrated Development Environment
Exec=/home/youruser/opt/eclipse/eclipse
Icon=/home/youruser/opt/eclipse/icon.xpm
Terminal=false
Type=Application
Categories=Development;IDE;Java;
StartupWMClass=Eclipse
~/workspace。編輯 eclipse/eclipse.ini (在 -vmargs 之前添加 -vm 指定 JDK):**
-vm
/home/youruser/.sdkman/candidates/java/current/bin/java
--launcher.GTK_version
3
-vmargs
-Dosgi.requiredJavaVersion=17
-Xms512m
-Xmx4g
-XX:+UseG1GC
-XX:+UseStringDeduplication
-Dfile.encoding=UTF-8
--add-modules=ALL-SYSTEM
-Xmx 設為物理記憶體 50%-75%,高分屏添加 -Dsun.java2d.uiScale=2 (或依賴 GTK3 自動縮放)。
lombok.jar 安裝)Window → Preferences → General → Workspace → Text file encoding: UTF-8New text file line delimiter: Unixformatter.xml (Java Code Style → Formatter) 和 cleanup.xml (Save Actions)。| 問題 | 原因與解決 |
|---|---|
啟動報錯 JVM terminated. Exit code=13 | JDK 位數不匹配 (32/64位) 或版本過低。確保 Eclipse 64位對應 JDK 64位,且 JDK 版本滿足 Eclipse 需求 (2024+ 需 JDK 17+)。檢查 eclipse.ini -vm 指向正確。 |
| 中文亂碼 | 系統/專案編碼不一致。強制 UTF-8:eclipse.ini 加 -Dfile.encoding=UTF-8,專案 Properties → Resource → Text file encoding: UTF-8。 |
| 高分屏模糊/過小 | GTK3 自動縮放問題。嘗試環境變數 GDK_SCALE=2 GDK_DPI_SCALE=0.5 啟動,或 eclipse.ini 加 -Dsun.java2d.uiScale=2 (Java 9+)。Wayland 下表現較好。 |
| SDKMAN! JDK 不被 Eclipse 識別 | 在 Window → Preferences → Java → Installed JREs → Add → Standard VM,JRE home 填 ~/.sdkman/candidates/java/current (符號鏈接指向當前版本)。 |
現代 Linux Java 開發環境最佳實踐:SDKMAN! 管理 JDK 版本 + Eclipse Installer 安裝/更新 IDE + 統一編碼格式化配置 + 必要外掛增強。此方案兼顧版本靈活性、系統整潔度、團隊協作一致性、長期維護性,避免了手動解壓配置環境變數帶來的路徑硬編碼、版本衝突、升級困難等歷史包袱。新手建議從 Ubuntu/Linux Mint + SDKMAN! + Eclipse Installer 起步。