この内容は古いバージョンです。最新バージョンを表示するには、戻るボタンを押してください。
バージョン:13
ページ更新者:T
更新日時:2026-06-11 07:12:00

タイトル: 環境構築
SEOタイトル: Java 開発環境構築完全ガイド — JDK/IDE/Maven/Gradle (2026 年版)

この記事の要点
  • OpenJDK ディストリビューションは複数: Adoptium (Eclipse Temurin) / Amazon Corretto / Microsoft Build of OpenJDK / Oracle JDK / Azul Zulu
  • 個人・OSS 利用なら Eclipse Temurin (旧 AdoptOpenJDK) が無料・LTS 長期サポートで定番
  • JAVA_HOME 環境変数 + PATH%JAVA_HOME%\bin を追加するのが基本セットアップ
  • 複数バージョンの切替には SDKMAN! (macOS/Linux) または jenv。Windows は手動切替か jabba
  • IDE は IntelliJ IDEA Community(無料) が最高生産性。Eclipse / VS Code + Extension Pack for Java も選択肢

JDK ディストリビューションの選択

Java 8 までは Oracle 一強でしたが、Oracle JDK のライセンス変更 (2019 年) 以降、OpenJDK の各ベンダー版を選ぶのが一般的です。

ディストリ提供元特徴ライセンス
Eclipse TemurinEclipse Foundation旧 AdoptOpenJDK、コミュニティ標準GPL+CE 無料
Amazon CorrettoAWSAWS 上で長期サポート、Lambda 公式GPL+CE 無料
Microsoft Build of OpenJDKMicrosoftAzure 環境向け、VS Code との親和性GPL+CE 無料
Oracle JDKOracle商用サポートありNFTC (商用は有償)
Azul ZuluAzul Systems幅広いプラットフォーム対応無料版あり
GraalVMOracleNative Image / PolyglotCE 無料

迷ったら Eclipse Temurin の最新 LTS (Java 21)。LTS は 8 / 11 / 17 / 21 / 25 (2025 年 9 月)。

インストール手順

Windows

  1. https://adoptium.net/ から MSI インストーラをダウンロード
  2. インストール時に「Set JAVA_HOME variable」「Add to PATH」にチェック
  3. コマンドプロンプトで java -version 確認
# winget での導入 (Windows 10 1809+ / 11)
winget install EclipseAdoptium.Temurin.21.JDK

# Chocolatey
choco install temurin21

# 確認
java -version
javac -version
echo $env:JAVA_HOME

macOS

# Homebrew
brew install --cask temurin@21

# 確認
java -version
/usr/libexec/java_home -V

# 複数バージョン管理は SDKMAN!
curl -s https://get.sdkman.io | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install java 21.0.5-tem
sdk install java 17.0.13-tem
sdk use java 21.0.5-tem
sdk default java 21.0.5-tem

Linux (Debian/Ubuntu)

# 公式パッケージ (Ubuntu)
sudo apt update
sudo apt install -y openjdk-21-jdk

# Temurin 公式リポジトリ
sudo apt install -y wget apt-transport-https gpg
wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo gpg --dearmor -o /etc/apt/keyrings/adoptium.gpg
echo "deb [signed-by=/etc/apt/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update
sudo apt install -y temurin-21-jdk

# 複数バージョン切替
sudo update-alternatives --config java

JAVA_HOME 環境変数

Maven / Gradle / IDE がインストール場所を見つけるために必須:

# Linux / macOS (~/.bashrc, ~/.zshrc)
export JAVA_HOME=/usr/lib/jvm/temurin-21-jdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

# macOS Homebrew
export JAVA_HOME=$(/usr/libexec/java_home -v 21)

# 確認
echo $JAVA_HOME
which java
java -version
# Windows (永続的にユーザー環境変数を設定)
[Environment]::SetEnvironmentVariable("JAVA_HOME",
    "C:\Program Files\Eclipse Adoptium\jdk-21.0.5.11-hotspot",
    "User")
[Environment]::SetEnvironmentVariable("PATH",
    "%JAVA_HOME%\bin;" + [Environment]::GetEnvironmentVariable("PATH","User"),
    "User")

# 新しい PowerShell ウィンドウで確認
echo $env:JAVA_HOME
java -version

複数バージョン管理

SDKMAN! (macOS/Linux 推奨)

# インストール
curl -s https://get.sdkman.io | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

# Java バージョン一覧
sdk list java

# インストール
sdk install java 21.0.5-tem
sdk install java 17.0.13-tem
sdk install java 8.0.432-tem

# 切替 (一時)
sdk use java 17.0.13-tem

# デフォルト変更
sdk default java 21.0.5-tem

# Maven / Gradle も同様に管理可能
sdk install maven 3.9.9
sdk install gradle 8.10.2

jenv (macOS/Linux)

brew install jenv
jenv add /Library/Java/JavaVirtualMachines/temurin-21.jdk/Contents/Home
jenv add /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
jenv global 21.0
jenv local 17.0   # プロジェクトディレクトリ単位

IDE 選定

IDE料金特徴
IntelliJ IDEA Community無料Java/Kotlin 開発の事実上標準
IntelliJ IDEA Ultimate有償Spring/JEE/SQL 補完など強化
Eclipse無料歴史長い、プラグイン豊富
VS Code + Extension Pack for Java無料軽量、Microsoft 推奨
NetBeans無料Java EE / GUI 開発向け

新規プロジェクトは IntelliJ IDEA Community で十分。Spring 開発でも Community 版で動きます。

Maven のインストール

# SDKMAN!
sdk install maven 3.9.9

# Homebrew
brew install maven

# 手動
wget https://archive.apache.org/dist/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz
tar -xzf apache-maven-3.9.9-bin.tar.gz -C /opt
export M2_HOME=/opt/apache-maven-3.9.9
export PATH=$M2_HOME/bin:$PATH

# 確認
mvn -version

# Maven プロジェクト雛形作成
mvn archetype:generate \
    -DgroupId=com.example \
    -DartifactId=myapp \
    -DarchetypeArtifactId=maven-archetype-quickstart \
    -DarchetypeVersion=1.4 \
    -DinteractiveMode=false

Gradle のインストール

# SDKMAN!
sdk install gradle 8.10.2

# Homebrew
brew install gradle

# 確認
gradle -version

# プロジェクト初期化
gradle init --type java-application --dsl kotlin

動作確認: Hello World

// Hello.java
public class Hello {
    public static void main(String[] args) {
        System.out.println("Hello, Java " + Runtime.version());
    }
}
javac Hello.java
java Hello
# → Hello, Java 21.0.5+11-LTS

# Java 11+ はコンパイル無しに実行可能
java Hello.java

よくあるトラブル

症状原因対処
java は動くが javac が動かないJRE だけインストールJDK を入れ直す
JAVA_HOME を設定しても反映されない新しいシェルで読み込み忘れ再ログインまたは source ~/.bashrc
Maven が古い Java を見ているJAVA_HOME 未設定~/.mavenrc に export
UnsupportedClassVersionError新しい JDK でビルドしたコードを古い JRE で実行--release オプションで揃える
SSL 証明書エラー社内プロキシで SSL 検査cacerts に企業証明書追加

FAQ

Q: Java 8 と 21 のどちらを学ぶ?
A: 既存プロジェクトメンテなら 8、新規なら21 (LTS)。8 は 2030 年で延長サポートも終了。

Q: Oracle JDK は無料で使えない?
A: 2023 年 9 月から NFTC (No-Fee Terms and Conditions) ライセンスで本番含めて無料化。ただし制約があり、業務利用は Temurin 等を選ぶ方が無難。

Q: M1/M2 Mac で動かしたい
A: Temurin / Corretto は ARM64 ネイティブビルドあり。x86_64 版でも Rosetta 2 経由で動くが遅い。

関連項目

  • JDK 21 LTS リリースノート
  • SDKMAN! — Java/Maven/Gradle/Spring CLI を一元管理
  • IntelliJ IDEA — JetBrains 公式 IDE
  • GraalVM — Native Image 対応 JDK