1. Mavenとは？Java開発における役割とインストール前に知っておきたい基礎知識
    1. Mavenの基本的な役割とできること
    2. ビルドライフサイクルと主要なフェーズ
    3. 依存関係管理の仕組みと注意点
  2. Mavenのインストール前に確認！必要なJDKのバージョンと導入の流れ
    1. Mavenのバージョン別に必要なJDK要件
    2. インストール前の確認事項と準備
    3. インストール全体の流れを把握する
  3. Windows・Mac・LinuxでのMavenインストール手順
    1. Windowsでのインストール手順
    2. Macでのインストール手順
    3. Linuxでのインストール手順
  4. コマンドで動作確認！MavenとJavaのバージョン確認方法
    1. mvn -vで確認できる情報とその意味
    2. java -versionとjavac -versionの確認
    3. バージョン不一致時の確認ポイント
  5. VS CodeとEclipseでMavenを使うための初期設定とプロジェクト作成
    1. VS CodeでのMaven環境構築
    2. EclipseでのMaven環境構築
    3. 各IDEでのプロジェクト作成時の共通ポイント
  6. インストール時のよくあるエラーと対処法
    1. 「mvn コマンドが見つかりません」エラー
    2. JDK関連のエラーとJAVA_HOME未設定
    3. 依存関係ダウンロードの失敗とプロキシ問題
  7. まとめ
  8. よくある質問
    1. Q: Mavenのインストールに必要なJDKのバージョンは？
    2. Q: WindowsでMavenをインストールする手順は？
    3. Q: MacでMavenをインストールする方法は？
    4. Q: LinuxでMavenをインストールするには？
    5. Q: VS CodeでMavenを使うための設定方法は？

Mavenとは？Java開発における役割とインストール前に知っておきたい基礎知識

Mavenの基本的な役割とできること

Apache Mavenは、Javaプロジェクトにおけるビルドツールです。プロジェクトのコンパイル、テスト実行、JARやWARといった成果物の生成、依存ライブラリの管理、リモートリポジトリへの公開まで、ビルド工程全体を自動化します。単なるライブラリ管理ツールやコンパイラではなく、決められたライフサイクルに沿って一連の処理を実行する統合的なツールだと理解しておきましょう。

設定の中心となるのは、XML形式のpom.xml（Project Object Model）です。プロジェクトの識別情報、依存ライブラリ、ビルドに使用するプラグイン、成果物の出力形式などをこのファイルに記述します。MavenはこのPOMを読み込み、必要なライブラリを自動でダウンロードしてビルドを進めます。

ビルドライフサイクルと主要なフェーズ

Mavenの動作は、あらかじめ定義されたビルドライフサイクルに基づきます。代表的なフェーズは、validate（検証）→ compile（コンパイル）→ test（テスト）→ package（パッケージ化）→ verify（統合テスト）→ install（ローカルリポジトリ登録）→ deploy（リモートリポジトリ公開）の順です。後ろのフェーズを実行すると、それより前の全フェーズが自動実行されます。

たとえばmvn packageを実行すれば、コンパイルとテストが完了した後にJARファイルが生成されます。またmvn installはローカルリポジトリに登録するだけであり、Maven Centralのような公開リポジトリへのアップロードにはmvn deployが必要です。

依存関係管理の仕組みと注意点

Mavenでは、必要な外部ライブラリをdependencyとしてpom.xmlに指定します。指定されたライブラリがさらに必要とする別ライブラリは、推移的依存関係として自動的に取得されます。これにより、手動でのライブラリ収集作業が大幅に削減されます。

依存関係のバージョン競合が発生した場合、依存ツリー上でプロジェクトに近い（深さが浅い）バージョンが優先されます。同じ深さであれば、先に宣言されたものが選ばれます。必ず最新版が選ばれるわけではないため、意図しないバージョンが使われる可能性がある点に注意しましょう。なお、dependencyManagementは依存ライブラリのバージョンを一元的に指定する仕組みであり、記述しただけでは依存関係は追加されません。

要点：Mavenはpom.xmlに基づいてビルド工程全体を自動化するツール。コンパイル、テスト、パッケージ化、依存管理までを統合的に実行し、packageはJAR生成、installはローカル登録、deployはリモート公開という役割の違いを正しく理解することが重要です。

Mavenのインストール前に確認！必要なJDKのバージョンと導入の流れ

Mavenのバージョン別に必要なJDK要件

Mavenの実行にはJDK（Java Development Kit）が必須です。Maven 3.9系の実行にはJDK 8以上が必要です。一方、Maven 4系（プレビュー版を含む）を動かすにはJDK 17以上が必要となります。

重要なのは、Mavenを実行するJDKと、ビルド対象となるJavaのバージョンは別物であるという点です。たとえばJDK 17でMavenを実行しながら、プロジェクトのコンパイルターゲットをJava 8に設定することも可能です。このような使い分けはToolchainsという仕組みで管理します。

インストール前の確認事項と準備

まず、システムにJDKがインストールされているか確認しましょう。コマンドラインでjava -versionおよびjavac -versionを実行し、JDKのバージョンが表示されれば準備完了です。未インストールの場合は、Oracle JDKやOpenJDKなど、自身の目的に合ったJDKを先に導入してください。

Maven本体はApache License 2.0で無償配布されており、公式サイトから誰でもダウンロードできます。利用料金はかかりませんが、ビルド時に取得する各ライブラリのライセンスは個別に確認する必要があります。また、CI環境や社内リポジトリ製品の費用は別途発生する場合があります。

インストール全体の流れを把握する

Maven導入の基本的な流れは次のとおりです。

  1. JDKをインストールし、PATHを設定する
  2. Mavenを公式サイトからダウンロードし、任意の場所に展開する
  3. 環境変数PATHにMavenのbinディレクトリを追加する
  4. mvn -vコマンドでMavenとJavaのバージョンを確認する
  5. pom.xmlを作成し、依存関係やビルド設定を記述する

チーム開発では、Maven Wrapperを使ってプロジェクトごとにMavenのバージョンを固定する手法も広く使われています。これにより、開発者全員が同じバージョンでビルドできる環境を簡単に再現できます。

要点：Maven 3.9系の実行にはJDK 8以上、Maven 4系の実行にはJDK 17以上が必要です。Mavenを動かすJDKとビルド対象のJavaバージョンは混同しないよう注意しましょう。インストール前にJDKの導入状況を確認し、基本的な導入手順を把握してから作業を始めてください。

Windows・Mac・LinuxでのMavenインストール手順

Windowsでのインストール手順

Windows環境では、まずJDKがインストールされ、環境変数JAVA_HOMEが設定されていることを確認します。Mavenは公式ダウンロードページからバイナリアーカイブ（zipファイル）を取得し、任意のフォルダ（例：C:\Program Files\Apache\Maven）に展開するだけで導入できます。

展開後、環境変数PATHにMavenのbinディレクトリへのパスを追加します。システム環境変数の設定画面から「Path」を編集し、C:\Program Files\Apache\Maven\binを新規追加してください。設定後はコマンドプロンプトを再起動し、mvn -vでバージョン情報が表示されることを確認します。

Macでのインストール手順

Mac環境では、Homebrewを使ったインストールが最も簡単です。ターミナルでbrew install mavenを実行すれば、最新安定版のMavenと必要なJDKが自動的にセットアップされます。Homebrewを使わない場合は、公式サイトからバイナリアーカイブ（tar.gzファイル）をダウンロードし、任意のディレクトリに展開します。

手動インストールの場合、展開したディレクトリを/usr/local/apache-mavenなどに配置し、~/.zshrcまたは~/.bash_profileにexport PATH=/usr/local/apache-maven/bin:$PATHを追記します。設定を反映するためにsource ~/.zshrcを実行し、mvn -vで確認しましょう。

Linuxでのインストール手順

Linux環境では、パッケージマネージャーを使用する方法と手動インストールの2通りがあります。UbuntuやDebian系であればsudo apt install maven、RHEL系であればsudo yum install mavenでインストール可能です。ただし、リポジトリで提供されるバージョンは最新安定版より古い場合があるため、特定のバージョンが必要な場合は手動インストールを推奨します。

手動インストールでは、公式サイトからtar.gzアーカイブをダウンロードし、/optや/usr/localに展開します。展開後、/etc/profile.d/maven.shなどのファイルを作成し、export PATH=/opt/apache-maven/bin:$PATHを記述してPATHを通します。設定後は新しいシェルを起動し、mvn -vで動作を確認してください。

OS 推奨インストール方法 PATH設定方法
Windows 公式zipを手動展開 システム環境変数からPathを編集
Mac Homebrew（brew install maven） シェル設定ファイルにexport文を追記
Linux パッケージマネージャーまたは手動 profile.d配下に設定ファイルを作成

要点：全OS共通で、MavenのbinディレクトリにPATHを通すことが必須です。Windowsはシステム環境変数、Macはシェル設定ファイル、Linuxはシステム全体またはユーザー単位のプロファイルで設定します。コマンドプロンプトやターミナルの再起動後にmvn -vで確認する習慣をつけましょう。

コマンドで動作確認！MavenとJavaのバージョン確認方法

mvn -vで確認できる情報とその意味

mvn -v（またはmvn --version）は、Mavenのインストール状態を確認する最も基本的なコマンドです。このコマンドを実行すると、Maven本体のバージョン、Javaバージョン、OS情報の3つが表示されます。表示されるJavaバージョンは、Mavenが実際に使用しているJDKであり、これがプロジェクトのコンパイルターゲットそのものではない点に注意しましょう。

実行例として、Apache Maven 3.9.16やJava version: 17.0.1といった出力が得られれば、正しくセットアップされています。何も表示されなかったり、コマンドが見つからないエラーが出る場合は、PATH設定が正しく行われていない可能性があります。

java -versionとjavac -versionの確認

Mavenの動作確認と同時に、JDKが正しくインストールされているかも確認しましょう。java -versionはJavaランタイムのバージョンを、javac -versionはJavaコンパイラのバージョンを表示します。Mavenはビルド時にコンパイラを使用するため、両方が正しく認識されている必要があります。

これらのコマンドが動作しない場合は、環境変数JAVA_HOMEが正しく設定されていない、またはJDKではなくJREのみがインストールされている可能性があります。Mavenの実行にはコンパイラを含むJDKが必須であり、JREだけでは不十分です。OracleのサイトやOpenJDKのディストリビューションからJDKを入手してください。

バージョン不一致時の確認ポイント

複数のJDKがインストールされている環境では、mvn -vで表示されるJavaバージョンと、java -versionで表示されるバージョンが異なる場合があります。これはPATHやJAVA_HOMEの優先順位によるもので、MavenはJAVA_HOMEを優先的に参照します。

バージョンの不一致に気づいたら、まずecho $JAVA_HOME（Windowsではecho %JAVA_HOME%）で現在の設定値を確認します。期待するJDKのパスが設定されていない場合は修正し、ターミナルを再起動してから再確認しましょう。Maven Wrapperを使用している場合は、プロジェクト固有の設定ファイル.mvn/wrapper/maven-wrapper.propertiesも確認してください。

要点：mvn -vでMavenバージョン、Javaバージョン、OS情報の3点を確認できます。java -versionとjavac -versionも併せて実行し、JDKが正しく導入されているか確認しましょう。複数JDK環境ではJAVA_HOMEの設定を優先的に確認してください。

VS CodeとEclipseでMavenを使うための初期設定とプロジェクト作成

VS CodeでのMaven環境構築

VS CodeでMavenを使用するには、まず拡張機能「Extension Pack for Java」をインストールします。このパックにはMaven for Java拡張が含まれており、インストール後にVS Codeを再起動すると、Mavenプロジェクトの作成やpom.xmlの編集支援が利用可能になります。

プロジェクトの作成は、コマンドパレット（Ctrl+Shift+P）から「Maven: Create Maven Project」を選択し、アーキタイプ（プロジェクトテンプレート）を選んで進めます。groupId、artifactId、プロジェクトの保存場所を入力すれば、必要なディレクトリ構造とpom.xmlが自動生成されます。

EclipseでのMaven環境構築

Eclipseにはm2e（Maven Integration for Eclipse）プラグインが標準で組み込まれており、追加のインストールは不要です。Eclipse上でMavenプロジェクトを作成するには、「ファイル」→「新規」→「Mavenプロジェクト」を選択します。シンプルなプロジェクトを作成する場合は「シンプルなプロジェクトの作成」にチェックを入れ、groupId、artifactId、versionを入力します。

既存のMavenプロジェクトをインポートするには、「ファイル」→「インポート」→「Existing Maven Projects」を選択し、pom.xmlが存在するディレクトリを指定します。Eclipseは自動的に依存関係を解決し、必要なライブラリをクラスパスに追加します。ビルドやテストの実行は、プロジェクトを右クリックして「Run As」→「Maven build」から行います。

各IDEでのプロジェクト作成時の共通ポイント

どちらのIDEでも、プロジェクト作成時に指定するgroupId、artifactId、versionは、成果物を一意に識別する重要な情報です。groupIdはプロジェクトの所属組織（例：com.example）、artifactIdはプロジェクト名、versionはそのバージョンを表します。この3つの組み合わせで、Mavenリポジトリ上の場所が決まります。

作成後は、pom.xmlに必要な依存ライブラリやプロパティを追記し、mvn testやmvn packageが正常に実行できることを確認しましょう。IDEに内蔵されたMavenと、コマンドラインで使用するMavenのバージョンが異なる場合があるため、チームで統一する際はMaven Wrapperの使用を検討してください。

項目 VS Code Eclipse
必要な拡張機能 Extension Pack for Java（別途インストール） m2e（標準搭載、追加不要）
プロジェクト作成方法 コマンドパレットからMaven: Create Maven Project 新規→Mavenプロジェクトウィザード
Wrapper自動設定 あり 手動または別途設定

要点：VS CodeはExtension Pack for Javaのインストールが必要、Eclipseは標準のm2eプラグインですぐに使えます。プロジェクト作成時はgroupId、artifactId、versionの3つを正しく設定し、作成後はpom.xmlへの依存関係追記とビルド動作確認を行いましょう。

インストール時のよくあるエラーと対処法

「mvn コマンドが見つかりません」エラー

このエラーは、コマンドラインがMavenの実行ファイルを見つけられない場合に発生します。原因のほとんどはPATHの設定漏れまたは設定後のターミナル再起動忘れです。Mavenを展開したディレクトリ配下のbinフォルダが、環境変数PATHに正しく追加されているか確認しましょう。

Windowsではシステムのプロパティから環境変数設定画面を開き、ユーザー環境変数またはシステム環境変数のPathにbinディレクトリのフルパスが含まれているか確認します。MacやLinuxでは、echo $PATHで現在のPATHを表示し、Mavenのパスが含まれているか確認してください。設定修正後は必ずターミナルを再起動します。

JDK関連のエラーとJAVA_HOME未設定

Mavenの実行時に「JAVA_HOME environment variable is not defined correctly」といったエラーが表示される場合は、JDKが正しく認識されていません。MavenはJDKに含まれるコンパイラ（javac）を必要とするため、JREのみの環境では動作しません。

対処法として、まずjava -versionとjavac -versionの両方が実行できるか確認します。javacが見つからない場合はJDKが未インストールか、PATHがJREのみを指しています。環境変数JAVA_HOMEにJDKのインストールディレクトリ（例：C:\Program Files\Java\jdk-17）を設定し、PATHに%JAVA_HOME%\bin（Windows）または$JAVA_HOME/bin（Mac/Linux）を追加してください。

依存関係ダウンロードの失敗とプロキシ問題

初回のビルド時に依存ライブラリのダウンロードが失敗するケースでは、ネットワーク接続やプロキシ設定が原因であることが多いです。MavenはデフォルトでMaven Centralリポジトリからライブラリを取得しますが、企業ネットワーク内では直接の外部接続が制限されている場合があります。

プロキシ環境下では、Mavenの設定ファイル~/.m2/settings.xml（Windowsでは%USERPROFILE%\.m2\settings.xml）にプロキシ設定を記述します。<proxies>セクションにホスト名とポート番号を指定し、必要に応じて認証情報も追加してください。また、社内リポジトリ（ミラー）が用意されている場合は、同ファイルの<mirrors>セクションで設定します。

要点：エラーの多くはPATH設定、JAVA_HOME未設定、ネットワーク接続の問題に起因します。mvnコマンドが見つからない場合はPATHを、JDKエラーはJAVA_HOMEを、ダウンロード失敗はsettings.xmlのプロキシ設定を確認してください。設定変更後は必ずターミナルを再起動しましょう。