はじめに (対象読者・この記事でわかること)

この記事は、これからJavaプログラミングを始めたいと考えている初心者の方や、新しいPCでJava開発環境を構築したい方を対象としています。特に、開発環境のセットアップでつまずきやすいJava Development Kit (JDK) のインストールに焦点を当てています。

この記事を読むことで、Oracle JDKのダウンロードからインストール、そしてJavaプログラムを実行するために不可欠な環境変数の設定までの一連の流れを完全に理解し、Javaアプリケーションを開発できる最初の状態にできるようになります。Java開発のスタートラインに立つための、つまずきやすいポイントを丁寧に解説していきますので、ご安心ください。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 * WindowsまたはmacOSの基本的な操作 * コマンドプロンプト (Windows) またはターミナル (macOS) の基本的な利用方法 * Webブラウザの基本的な操作

Java開発の要「JDK」とは？Oracle JDKを選ぶ理由

Javaでアプリケーションを開発するには、Java Development Kit (JDK) と呼ばれるツールキットが必要です。JDKには、Javaのソースコードをコンピュータが理解できる形式に変換するコンパイラ（javac）、そしてコンパイルされたプログラムを実行するためのJava仮想マシン（JVM）を含むJava Runtime Environment (JRE) など、開発に必要なあらゆるツールが含まれています。

一言で言えば、JDKがなければJavaプログラムを書いたり実行したりすることはできません。

世の中には様々なJDKのディストリビューションが存在しますが、その中でもOracle社が提供するOracle JDKは、Javaの標準的な実装の一つとして広く利用されています。Oracle JDKは、かつて商用利用に関してライセンス体系の変更がありましたが、個人学習や開発用途では引き続き無償で利用可能です。今回は、このOracle JDKのインストール方法に焦点を当てて解説していきます。

WindowsとmacOSでOracle JDKをインストールする完全ガイド

ここからは、Oracle JDKをダウンロードしてインストールし、正しく環境変数を設定するまでの具体的な手順を、WindowsとmacOSの両方について解説していきます。

ステップ1: Oracleアカウントの作成とJDKのダウンロード

まず、Oracle公式サイトからJDKをダウンロードします。Oracle JDKのダウンロードには、Oracleアカウントが必要です。

  1. Oracle Javaダウンロードページへアクセス: お使いのWebブラウザで、Oracle社のJavaダウンロードページにアクセスします。最新バージョンのJDKが提供されていますので、「Java Downloads」などのリンクを探してください。 Oracle Java Downloads

  2. JDKバージョンの選択: 通常は、最新のLTS (Long Term Support) バージョンを選択することをおすすめします。ページをスクロールし、お使いのOS (WindowsまたはmacOS) に対応するインストーラを見つけます。

    • Windowsの場合: 「x64 Installer」と書かれた.exeファイルをダウンロードします。
    • macOSの場合: 「macOS Arm64 Installer」(M1/M2/M3チップ搭載Macの場合) または「macOS x64 Installer」(Intelチップ搭載Macの場合) と書かれた.dmgファイルをダウンロードします。ご自身のMacのCPUアーキテクチャを確認してから選択してください。

  3. Oracleアカウントでのログイン/作成: ダウンロードリンクをクリックすると、Oracleアカウントへのログインが求められます。アカウントをお持ちでない場合は、「アカウントの作成」をクリックして指示に従い、アカウントを作成してください。作成が完了したら、ログインしてダウンロードを続行します。

ステップ2: JDKインストーラの実行

ダウンロードしたファイルをダブルクリックして、インストールを開始します。

Windowsの場合

  1. ダウンロードした.exeファイルをダブルクリックして実行します。
  2. 「ユーザーアカウント制御」のダイアログが表示されたら「はい」をクリックします。
  3. インストールウィザードが起動しますので、「Next >」をクリックします。
  4. インストール先のフォルダが表示されます。通常はデフォルトのままで問題ありませんが、変更したい場合は「Change...」をクリックして指定します。特にこだわりがなければ、デフォルトのまま「Next >」をクリックします。 （例：C:\Program Files\Java\jdk-xx のようになります。xx はバージョン番号）
  5. インストールが開始され、完了すると「Successfully Installed」と表示されます。「Close」をクリックしてウィザードを閉じます。

macOSの場合

  1. ダウンロードした.dmgファイルをダブルクリックしてマウントします。
  2. 開いたウィンドウ内に表示される「JDK xx.pkg」（xxはバージョン番号）ファイルをダブルクリックして実行します。
  3. インストールウィザードが起動しますので、「続ける」をクリックします。
  4. 「インストール先」や「インストールの種類」を選択する画面が表示されますが、通常はデフォルトのままで問題ありません。「インストール」をクリックします。
  5. macOSのパスワードの入力を求められたら入力し、「ソフトウェアをインストール」をクリックします。
  6. インストールが開始され、完了すると「インストールが完了しました」と表示されます。「閉じる」をクリックしてウィザードを閉じます。.dmgファイルはゴミ箱に入れても構いません。 （インストール先：通常 /Library/Java/JavaVirtualMachines/jdk-xx.jdk/Contents/Home となります）

ステップ3: 環境変数の設定 (JAVA_HOME と Path)

JDKをインストールしただけでは、Javaコマンドをどこからでも実行できるようにはなりません。OSがJavaの実行ファイルを見つけられるように、「環境変数」を設定する必要があります。

Windowsの場合

  1. システムプロパティを開く: デスクトップの「PC」（または「コンピューター」）を右クリックし、「プロパティ」を選択します。左側のメニューから「システムの詳細設定」をクリックし、「システムのプロパティ」ウィンドウを開きます。「詳細設定」タブの「環境変数(N)...」ボタンをクリックします。

  2. JAVA_HOMEの設定: 「システム環境変数」の欄にある「新規(N)...」をクリックします。

    • 変数名: JAVA_HOME
    • 変数値: JDKをインストールしたパス（例: C:\Program Files\Java\jdk-xx） 入力したら「OK」をクリックします。

  3. Path変数の設定: 「システム環境変数」の欄で「Path」を選択し、「編集(I)...」をクリックします。 「新規(N)」をクリックし、%JAVA_HOME%\bin と入力します。 （%JAVA_HOME% は先ほど設定した JAVA_HOME 変数の値を参照します） 追加したら、一番上に移動させるなどして、優先順位を高くしておくことをおすすめします。「OK」を数回クリックして、開いているウィンドウをすべて閉じます。

macOSの場合

macOSの場合、通常はインストーラが自動でパスを設定してくれることが多いですが、念のため確認し、必要であれば手動で設定します。JAVA_HOME は特にIDEなどから参照されることがあるため、設定しておくと良いでしょう。

  1. ターミナルを開く: Spotlight検索 (Command + Space) で「ターミナル」と入力して起動します。

  2. シェル設定ファイルを開く: macOS Catalina以降のデフォルトシェルはZshです。設定ファイルは ~/.zshrc です。Bashを使っている場合は ~/.bash_profile です。 以下のコマンドでエディタ（nano）でファイルを開きます。 bash nano ~/.zshrc （Bashの場合は nano ~/.bash_profile）

  3. JAVA_HOMEとPathの追加: ファイルの末尾に以下の行を追加します。jdk-xx.jdk の部分は、インストールしたJDKのバージョンに合わせてください。java -version コマンドなどでバージョンを確認できます。 bash export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk-xx.jdk/Contents/Home" export PATH="$PATH:$JAVA_HOME/bin" 例: JDK 21の場合 export JAVA_HOME="/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home"

    • 入力後、Control + O で保存し、Enter でファイル名を確定、Control + X でエディタを終了します。

  4. 設定の反映: 変更を反映させるために、以下のコマンドを実行します。 bash source ~/.zshrc （Bashの場合は source ~/.bash_profile）

設定の確認

環境変数の設定が正しく行われたかを確認するために、コマンドプロンプト（Windows）またはターミナル（macOS）を新しく開き直して、以下のコマンドを実行します。

Bash

java -version
javac -version

それぞれのコマンドで、インストールしたJDKのバージョン情報が表示されれば成功です！

java version "xx.0.x" yyymmdd
Java(TM) SE Runtime Environment (build xx.0.x+x-LTS)
Java HotSpot(TM) 64-Bit Server VM (build xx.0.x+x-LTS, mixed mode, sharing)

上記のような出力が得られれば、Java開発環境の構築は完了です。

ハマった点やエラー解決

「'java' は、内部コマンドまたは外部コマンド、操作可能なプログラムまたはバッチ ファイルとして認識されていません。」 (Windows) / 「Command not found: java」 (macOS)

  • 原因: Path 環境変数が正しく設定されていないか、設定が反映されていません。
  • 解決策:
    1. コマンドプロンプト/ターミナルの再起動: 環境変数を変更した後は、既存のウィンドウを閉じ、新しく開き直す必要があります。
    2. JAVA_HOME と Path のパスの確認: スペルミスや、JDKのインストールパスが間違っていないか、もう一度確認してください。特にWindowsでは、%JAVA_HOME%\bin のように変数を正しく参照しているか確認します。
    3. Windowsの場合: 「システム環境変数」の「Path」で、%JAVA_HOME%\bin が他のJava関連のパスよりも上位（先に評価される場所）にあるか確認します。
    4. macOSの場合: ~/.zshrc (または ~/.bash_profile) の内容が正しいか、そして source コマンドでファイルが読み込まれているかを確認します。

複数のJavaバージョンがインストールされている場合

  • 原因: 以前に別のJDKをインストールしていたり、IDEが独自のJDKをバンドルしていたりする場合、意図しないバージョンのJavaが参照されることがあります。
  • 解決策:
    1. Path 環境変数の優先順位を確認: OSはPathに記述されたディレクトリを上から順に検索します。目的のJDKのbinディレクトリが、他のJava関連ディレクトリよりも先に来るように調整します。
    2. 不要なJDKのアンインストール: 今後使用しない古いJDKなどがあれば、アンインストールすることで競合を避けることができます。
    3. バージョン管理ツールの利用: macOSであれば jenv、Linuxであれば update-alternatives といったツールを使用すると、複数のJavaバージョンを簡単に切り替えることができます。

Oracleアカウントのログインループやダウンロードエラー

  • 原因: ブラウザのキャッシュやCookie、ネットワーク設定などが原因で、Oracleの認証システムが正常に動作しない場合があります。
  • 解決策:
    1. ブラウザのキャッシュとCookieをクリアしてから再度試します。
    2. 別のWebブラウザ（Chrome、Firefox、Edgeなど）を試してみます。
    3. 一時的にVPNを切る、または別のネットワーク環境で試してみます。

解決策

これらの問題のほとんどは、環境変数の設定ミスか、設定の反映漏れが原因です。焦らず、以下のステップで再確認しましょう。

  1. JDKのインストールパスを正確に確認する: エクスプローラー（Windows）やFinder（macOS）で実際にフォルダに移動し、パスをコピー＆ペーストするのが確実です。
    • Windows例: C:\Program Files\Java\jdk-xx
    • macOS例: /Library/Java/JavaVirtualMachines/jdk-xx.jdk/Contents/Home
  2. 環境変数の設定を最初から見直す: 特にスペルミス、全角/半角の違い、余分なスペースがないかを確認します。
  3. 設定変更後は必ずコマンドプロンプト/ターミナルを再起動する: これが最も忘れられがちなポイントです。
  4. echo %JAVA_HOME% (Windows) や echo $JAVA_HOME (macOS) で変数の中身を確認する: これにより、設定したJAVA_HOMEが正しくOSに認識されているか確認できます。

まとめ

本記事では、Java開発の第一歩となるOracle JDKのインストール方法を、WindowsとmacOSの両方について詳しく解説しました。

  • Oracleアカウントを作成し、必要なJDKインストーラをダウンロードしました。
  • ダウンロードしたインストーラを実行し、JDKをシステムにインストールしました。
  • Javaコマンドがどこからでも実行できるように、JAVA_HOMEとPathという重要な環境変数を設定しました。

この記事を通して、あなたはJavaプログラムをコンパイルし、実行するための基本的な環境を整えることができました。これは、Javaプログラミング学習の非常に大きな一歩です。開発環境の構築は最初の難関ですが、これを乗り越えれば、いよいよコードを書くことに集中できます。

今後は、EclipseやIntelliJ IDEAといった統合開発環境(IDE)を導入し、さらに快適な開発環境を構築する方法や、簡単なJavaプログラムの作成、コンパイル、実行の方法についても記事にする予定です。

参考資料