萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

Ubuntu 安裝 Java 開發環境完整教學:JDK、環境變數、Eclipse IDE 一站式設定

前言

在 Ubuntu 上建置 Java 開發環境,核心步驟為:安裝 JDK (Java Development Kit)、設定環境變數、安裝 IDE (如 Eclipse/IntelliJ IDEA/VS Code)。本文提供步驟詳細、指令可複製貼上、含常見坑點排除的完整指南。

第一階段:安裝 JDK (推薦使用套件管理器)

方法 A:使用 apt 安裝 OpenJDK (最簡單、自動更新、系統整合佳)

# 更新套件列表
sudo apt update

# 查看可用版本
apt search openjdk | grep -E '^openjdk-[0-9]+-jdk/'

# 安裝 LTS 版本 (推薦 17 或 21)
sudo apt install openjdk-17-jdk-headless  # 無圖形介面伺服器環境
# 或
sudo apt install openjdk-17-jdk           # 含圖形庫,桌面開發用

# 驗證安裝
java -version
javac -version

優點:自動處理相依套件、路徑設定、安全性更新、update-alternatives 管理多版本切換。

方法 B:手動安裝 Oracle JDK / 其他發行版 (需特定版本時)

  1. 前往 jdk.java.net 或 Oracle 下載頁 下載 .tar.gz 壓縮檔 (如 openjdk-21_linux-x64_bin.tar.gz)。
  2. 解壓至 /opt/java (需 root):
    sudo mkdir -p /opt/java
    sudo tar -xzf ~/Downloads/openjdk-21_linux-x64_bin.tar.gz -C /opt/java
    # 解壓後目錄通常為 /opt/java/jdk-21 或 /opt/java/jdk-21.0.x
  3. 設定 update-alternatives 註冊並切換版本:
    sudo update-alternatives --install /usr/bin/java java /opt/java/jdk-21/bin/java 100
    sudo update-alternatives --install /usr/bin/javac javac /opt/java/jdk-21/bin/javac 100
    sudo update-alternatives --config java   # 互動式選擇預設版本
    sudo update-alternatives --config javac

第二階段:設定環境變數 (關鍵步驟)

編輯 ~/.bashrc (僅當前使用者) 或 /etc/profile.d/java.sh (全系統):

# ~/.bashrc 末尾加入
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64  # apt 安裝典型路徑,實際請用 `readlink -f $(which java)` 確認
# 手動安裝則為 export JAVA_HOME=/opt/java/jdk-21

export PATH=$JAVA_HOME/bin:$PATH
# CLASSPATH 現代專案通常由 Maven/Gradle 管理,不需手動設定
# 如需設定:export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

套用變更:

source ~/.bashrc
# 或重新開啟終端機

驗證:

echo $JAVA_HOME
java -version
javac -version

第三階段:安裝 Eclipse IDE (或其他 IDE)

方法 A:安裝 Eclipse Installer (官方推薦,可管理多工作區/版本)

# 下載 Eclipse Installer (Linux x86_64)
wget -O ~/eclipse-inst-linux64.tar.gz "https://www.eclipse.org/downloads/download.php?file=/oomph/epp/2024-03/R/eclipse-inst-jre-linux64.tar.gz&r=1"
tar -xzf ~/eclipse-inst-linux64.tar.gz -C ~/
~/eclipse-installer/eclipse-inst  # 執行圖形化安裝程式,選擇 "Eclipse IDE for Java Developers"

方法 B:直接下載解壓 Eclipse 套件 (舊式、單一檔案)

# 下載 Eclipse IDE for Java Developers (Linux x86_64)
wget -O ~/eclipse-java-linux64.tar.gz "https://www.eclipse.org/downloads/download.php?file=/technology/epp/downloads/release/2024-03/R/eclipse-java-2024-03-R-linux-gtk-x86_64.tar.gz&r=1"
mkdir -p ~/opt
tar -xzf ~/eclipse-java-linux64.tar.gz -C ~/opt
# 執行:~/opt/eclipse/eclipse

方法 C:使用 Flatpak (沙盒、自動更新、桌面整合佳)

flatpak install flathub org.eclipse.Java
# 執行:flatpak run org.eclipse.Java

建立桌面捷徑 (方法 B 手動解壓需自行建立)

cat < ~/.local/share/applications/eclipse.desktop
[Desktop Entry]
Name=Eclipse IDE
Comment=Eclipse Integrated Development Environment
Exec=/home/你的用戶名/opt/eclipse/eclipse
Icon=/home/你的用戶名/opt/eclipse/icon.xpm
Terminal=false
Type=Application
Categories=Development;IDE;Java;
StartupWMClass=Eclipse
EOF

第四階段:Eclipse 整合 JDK 與建立專案

  1. 啟動 Eclipse,選擇工作區 (Workspace) 目錄 (如 ~/workspace)。
  2. 設定 JDK:Window → Preferences → Java → Installed JREs → Add... → Standard VM → Directory: 選擇 JAVA_HOME 路徑,勾選設為預設。
  3. 設定編譯器版本:Preferences → Java → Compiler → Compiler compliance level 設為 17 或 21。
  4. 建立專案:File → New → Java Project,輸入專案名,選擇 "Use an execution environment JRE: JavaSE-17",Finish。
  5. 建立類別:右鍵 src → New → Class,勾選 public static void main(String[] args),撰寫 System.out.println("Hello Ubuntu Java!");,Ctrl+F11 執行。

常見問題排除

問題原因與解決
command not found: java環境變數未生效。檢查 echo $JAVA_HOME、which java、重開終端機或 source ~/.bashrc。
Eclipse 啟動報錯 "Failed to create the Java Virtual Machine"eclipse.ini 中 -vm 未指定正確 JDK 路徑,或 32/64 位元不匹配。在 -vmargs 前加入 -vm\n/opt/java/jdk-21/bin/java (換行分隔)。
中文亂碼Eclipse Preferences → General → Workspace → Text file encoding: UTF-8;專案右鍵 Properties → Resource → UTF-8。
無法解析 Maven/Gradle 依賴檢查 settings.xml 鏡像源 (阿里雲/騰訊雲)、代理設定、JDK 版本相容性。
Flatpak 版 Eclipse 無法存取宿主機檔案Flatpak 沙盒隔離。使用 flatpak override --filesystem=home org.eclipse.Java 或改用原生安裝。

替代方案:IntelliJ IDEA Community / VS Code

  • IntelliJ IDEA Community:免費、功能強大、智慧感知優於 Eclipse。sudo snap install intellij-idea-community --classic 或 flatpak install flathub com.jetbrains.IntelliJ-IDEA-Community。
  • VS Code + Extension Pack for Java:輕量、啟動快、擴充性強。安裝 Extension Pack for Java (Microsoft) 即獲完整 Java 支援 (Maven, Gradle, Debug, Test, Spring Boot)。

結語

Ubuntu 上 Java 開發環境建置,核心在於 正確安裝 JDK → 正確設定 JAVA_HOME/PATH → 選擇趁手 IDE。建議新手優先使用 apt install openjdk-17-jdk + VS Code (Java Extension Pack) 或 IntelliJ IDEA Community,體驗最順暢、維護最省心。Eclipse 適合習慣其工作流或企業舊專案維護者。

copyright © 萬盛學電腦網 all rights reserved