在 Ubuntu 上建置 Java 開發環境,核心步驟為:安裝 JDK (Java Development Kit)、設定環境變數、安裝 IDE (如 Eclipse/IntelliJ IDEA/VS Code)。本文提供步驟詳細、指令可複製貼上、含常見坑點排除的完整指南。
# 更新套件列表
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 管理多版本切換。
.tar.gz 壓縮檔 (如 openjdk-21_linux-x64_bin.tar.gz)。/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
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 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"
# 下載 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
flatpak install flathub org.eclipse.Java
# 執行:flatpak run org.eclipse.Java
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
~/workspace)。Window → Preferences → Java → Installed JREs → Add... → Standard VM → Directory: 選擇 JAVA_HOME 路徑,勾選設為預設。Preferences → Java → Compiler → Compiler compliance level 設為 17 或 21。File → New → Java Project,輸入專案名,選擇 "Use an execution environment JRE: JavaSE-17",Finish。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 或改用原生安裝。 |
sudo snap install intellij-idea-community --classic 或 flatpak install flathub com.jetbrains.IntelliJ-IDEA-Community。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 適合習慣其工作流或企業舊專案維護者。