Ubuntu 搭建 Java 開發環境筆記

Ubuntu 上安裝 JDK、IDE 並運行第一個程序

記錄在 Ubuntu 系統上從零搭建 Java 開發環境的步驟，包含 JDK 安裝、環境變量配置、默認版本切換、IDE 安裝及 Hello World 驗證。

1. 安裝 JDK (以 OpenJDK 17 為例，推荐 LTS 版本)

# 更新軟件源
sudo apt update

# 安裝 OpenJDK 17 (包含 JRE + 編譯器)
sudo apt install openjdk-17-jdk

# 驗證安裝
java -version
javac -version

輸出示例：

openjdk version "17.0.8" 2023-07-18
OpenJDK Runtime Environment (build 17.0.8+7-Ubuntu-1ubuntu122.04)
OpenJDK 64-Bit Server VM (build 17.0.8+7-Ubuntu-1ubuntu122.04, mixed mode, sharing)

2. 配置環境變量 (可選，apt 安裝通常已自動配置)

編輯 /etc/environment (全局) 或 ~/.bashrc (用戶級)：

# 在文件末尾添加
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
# CLASSPATH 通常不需要顯式設置，現代構建工具自動管理

生效：source /etc/environment 或重新打開終端。

3. 切換默認 Java 版本 (多版本共存時)

# 查看已安裝版本
update-java-alternatives --list

# 切換為 java-17-openjdk-amd64
sudo update-java-alternatives --set java-17-openjdk-amd64

4. 安裝 IDE (推薦 IntelliJ IDEA Community / VS Code)

IntelliJ IDEA (Snap 安裝最簡單)

sudo snap install intellij-idea-community --classic

VS Code + Extension Pack for Java

sudo snap install code --classic
# 然後在 VS Code 擴展市場搜索安裝 "Extension Pack for Java"

5. 編寫並運行第一個程序

# 1. 創建項目目錄
mkdir -p ~/java/helloworld/src/com/example
cd ~/java/helloworld

# 2. 編寫源碼 src/com/example/HelloWorld.java
cat > src/com/example/HelloWorld.java << 'EOF'
package com.example;

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, World from Ubuntu!");
    }
}
EOF

# 3. 編譯
javac -d out src/com/example/HelloWorld.java

# 4. 運行
java -cp out com.example.HelloWorld
# 輸出: Hello, World from Ubuntu!

6. 使用構建工具

實際項目建議使用 Maven 或 Gradle 管理依賴、構建、測試：

# 安裝 Maven
sudo apt install maven

# 創建標準項目
mvn archetype:generate -DgroupId=com.example -DartifactId=myapp -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

常見問題

• JAVA_HOME not found：確認 JAVA_HOME 指向 JDK 目錄 (含 bin/javac)，而非 JRE 目錄。
• 權限問題：sudo 僅用於系統級安裝，項目代碼請在用戶目錄下操作。
• 中文亂碼：確保終端、文件編碼、JVM 文件編碼均為 UTF-8 (-Dfile.encoding=UTF-8)。