閉じる

Java JDKのインストール確認方法をOS別に解説：コマンド操作から環境変数のチェックまで

広告

Javaプログラミングを始めるにあたって、最初の関門となるのが開発環境の構築です。

インストーラーを実行してインストールを完了しただけでは、システムが正しくJavaを認識しているとは限りません。

プログラムをコンパイルし、実行するためには、OS側で適切な設定が行われているかを確認する作業が不可欠です。

本記事では、Windows、macOS、Linuxの各OSにおいて、JDKが正しくインストールされ、コマンドラインから利用可能な状態になっているかを確認する手順を詳しく解説します。

目次 [ close ]
  1. JDKのインストール確認が必要な理由
  2. 全OS共通：コマンドによる基本確認方法
    1. javaコマンドによる実行環境の確認
    2. javacコマンドによるコンパイラの確認
  3. Windows環境での詳細確認と環境設定
    1. コマンドプロンプトでの確認手順
    2. JAVA_HOMEとPathの確認
  4. macOS環境での確認とパスの管理
    1. ターミナルでのバージョン確認
    2. /usr/libexec/java_home の活用
  5. Linux環境での確認と複数バージョンの切り替え
    1. update-alternatives コマンドの利用
  6. トラブルシューティング：よくあるエラーと対処法
    1. 「'java' は、内部コマンドまたは外部コマンドとして認識されていません」
    2. バージョンが古いまま更新されない
  7. 最終確認：Javaプログラムのコンパイルと実行
  8. まとめ

JDKのインストール確認が必要な理由

JDK (Java Development Kit) をインストールした後、なぜわざわざ確認作業を行う必要があるのでしょうか。

それは、Javaのプログラムを動かすためには「実行環境 (JRE)」だけでなく、「コンパイラ (javac)」が正しく動作し、かつシステムがそれらの場所を正確に把握している必要があるからです。

多くの場合、インストーラーは自動的にパスを通す処理を行いますが、複数のバージョンが混在していたり、設定が競合していたりすると、意図しないバージョンのJavaが起動してしまうことがあります。

開発現場では特定のプロジェクトに合わせたJavaバージョンを使用することが求められるため、現在の環境がどうなっているかを把握することは、トラブルシューティングの第一歩となります。

全OS共通：コマンドによる基本確認方法

まずは、OSの種類を問わず共通で使用できるコマンドを使って、インストール状況を確認しましょう。

確認すべきコマンドは主に2つあります。

javaコマンドによる実行環境の確認

java -version コマンドは、現在システムで有効になっているJava実行環境 (JRE) のバージョンを表示します。

Shell
# Javaのバージョンを確認するコマンド
java -version

このコマンドを実行した際、以下のような出力が表示されれば、少なくともJavaの実行環境はパスが通っています。

text
openjdk version "21.0.2" 2024-01-16
OpenJDK Runtime Environment (build 21.0.2+13-LTS)
OpenJDK 64-Bit Server VM (build 21.0.2+13-LTS, mixed mode, sharing)

もしここで 「コマンドが見つかりません」 というエラーが出る場合は、インストール自体に失敗しているか、環境変数にパスが追加されていません。

javacコマンドによるコンパイラの確認

Java開発においては、プログラムをビルドするためのコンパイラである javac が動作することが重要です。

Shell
# Javaコンパイラのバージョンを確認するコマンド
javac -version

実行結果として、以下のようにバージョンが表示されることを確認してください。

text
javac 21.0.2

javaコマンドは通るのにjavacコマンドが通らないという状況はよく起こります。

これは、JRE (実行用) のみインストールされており、JDK (開発用) がインストールされていない、あるいはJDKのパスが正しく設定されていないことを示しています。

Windows環境での詳細確認と環境設定

Windows OSでは、コマンドプロンプトやPowerShellを使用して確認を行います。

また、Windows特有の「環境変数」の設定状況が動作に大きく影響します。

コマンドプロンプトでの確認手順

Windowsキーを押して「cmd」と入力し、コマンドプロンプトを起動します。

前述の java -version および javac -version を実行してください。

もし正常に表示されない場合は、「環境変数」が正しく設定されているかを確認する必要があります。

Windowsでは、システムのプロパティから環境変数を編集します。

JAVA_HOMEとPathの確認

Javaの運用で最も重要視されるのが JAVA_HOME という変数です。

これはJDKがインストールされているフォルダの場所を指し示すものです。

変数名役割設定例
JAVA_HOMEJDKのインストールディレクトリを指定C:\Program Files\Java\jdk-21
Path実行ファイルの検索パスを指定%JAVA_HOME%\bin

環境変数が正しく設定されているかをコマンドラインで確認するには、以下のコマンドを入力します。

PowerShell
# JAVA_HOMEの設定値を確認する(PowerShell)
echo $env:JAVA_HOME

# Command Promptの場合
echo %JAVA_HOME%

出力として、インストールしたJDKのパスが表示されれば正常です。

空行が返ってくる場合は、システム設定から環境変数の追加が必要です。

macOS環境での確認とパスの管理

macOSでは、標準のシェルがZsh (以前はBash) であり、Javaの管理方法がWindowsとは異なります。

ターミナルでのバージョン確認

「ターミナル.app」を起動し、同様にコマンドを入力します。

macOSの場合、複数のJavaバージョンを管理するためのツールが標準で備わっています。

Shell
# macOSでのJavaバージョン確認
java -version

/usr/libexec/java_home の活用

macOSには /usr/libexec/java_home という便利なユーティリティが存在します。

これを利用することで、現在有効なJDKのパスを簡単に取得できます。

Shell
# インストールされているJDKのパスを一覧表示する
/usr/libexec/java_home -V
実行結果
Matching Java Virtual Machines (1):
    21.0.2 (arm64) "Oracle Corporation" - "Java SE 21" /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home

macOSで環境変数を設定する場合、~/.zshrc ファイルに以下のような記述を加えるのが一般的です。

Shell
# .zshrcへの記述例
export JAVA_HOME=$(/usr/libexec/java_home -v 21)
export PATH=$JAVA_HOME/bin:$PATH

設定を反映させるには、source ~/.zshrc を実行するか、ターミナルを再起動してください。

Linux環境での確認と複数バージョンの切り替え

Linux (UbuntuやCentOSなど) では、パッケージマネージャーを使ってJDKをインストールすることが一般的です。

そのため、複数のバージョンがインストールされやすく、どのバージョンが「優先」されているかの確認が重要です。

update-alternatives コマンドの利用

Debian系のOS (Ubuntu等) では、update-alternatives コマンドを使用して、使用するJavaのバージョンを管理・確認します。

Shell
# Javaの優先順位を確認・変更する
sudo update-alternatives --config java

このコマンドを実行すると、システム内のJava一覧が表示されます。

text
  選択       パス                                              優先度  状態
------------------------------------------------------------
* 0            /usr/lib/jvm/java-21-openjdk-amd64/bin/java      2111      自動モード
  1            /usr/lib/jvm/java-11-openjdk-amd64/bin/java      1111      手動モード
  2            /usr/lib/jvm/java-21-openjdk-amd64/bin/java      2111      手動モード

現在の設定がアスタリスク (*) で示されます。

意図したバージョンが選択されているかをここでチェックします。

トラブルシューティング：よくあるエラーと対処法

インストール確認時に発生しやすい問題とその解決策をまとめました。

「’java’ は、内部コマンドまたは外部コマンドとして認識されていません」

このエラーは、Windowsにおいて実行ファイルへのパスが通っていないことを意味します。

  • 原因： 環境変数 Path に C:\Program Files\Java\jdk-2x\bin が追加されていない。
  • 対策： 環境変数設定画面を開き、システムの「Path」変数に正しいbinフォルダのパスを追記してください。設定後、必ずコマンドプロンプトを再起動して反映を確認してください。

バージョンが古いまま更新されない

新しいJDKをインストールしたはずなのに、java -version の結果が古いバージョンのままの場合があります。

  • 原因： Path 変数の中で、古いJavaのパスが新しいものより上の行に記述されている。
  • 対策： 環境変数設定で、新しいJDKのパスをリストの一番上に移動させます。macOS/Linuxの場合は、.zshrc 等での記述順序を確認してください。

最終確認：Javaプログラムのコンパイルと実行

コマンドの確認が終わったら、最後に実際に小さなプログラムを動かして「真のインストール確認」を行いましょう。

以下のコードを Check.java という名前で保存してください。

Java
public class Check {
    public static void main(String[] args) {
        // システムプロパティからJavaのバージョンを取得して表示
        String version = System.getProperty("java.version");
        System.out.println("Javaの動作確認に成功しました！");
        System.out.println("実行中のバージョン: " + version);
    }
}

保存したディレクトリで、以下のコマンドを順番に実行します。

Shell
# 1. コンパイル (javacを使用)
javac Check.java

# 2. 実行 (javaを使用)
java Check
実行結果
Javaの動作確認に成功しました！
実行中のバージョン: 21.0.2

このように、javac でエラーが出ず、java コマンドでプログラムの結果が出力されれば、あなたの環境のJDKインストールと設定は完璧に完了しています。

まとめ

Java JDKのインストール確認は、単にバージョンを表示させるだけでなく、「javacコマンドが使えるか」「環境変数JAVA_HOMEが正しく設定されているか」といった点まで踏み込んで確認することが大切です。

OSごとに確認ツールや設定ファイルの場所は異なりますが、共通して言えるのは「システムがどの場所にあるJavaを見ているか」を意識することです。

もし設定がうまくいかない場合は、本記事で紹介したOS別の確認手順やトラブルシューティングを参考に、環境変数を見直してみてください。

正しく環境が整えば、あとはプログラミングに集中するだけです。

快適なJava開発ライフをスタートさせましょう。

URLをコピーしました！