Maven よく使うコマンド

Maven コマンドは以下のパターンに従います:

mvn [选项] [生命周期阶段] [目标]

Maven のバージョンを確認する

例

mvn -v

このコマンドは、インストールされている Maven バージョン、Java バージョンなどの情報を表示します。


Maven ライフサイクルコマンド

Maven はビルドライフサイクルの概念に基づいており、3つの主要なライフサイクルがあります:

  1. clean:プロジェクトをクリーンアップする
  2. default (build):プロジェクトを構築する
  3. site:プロジェクトドキュメントを生成する

プロジェクトのクリーン

例

mvn clean

このコマンドはtargetディレクトリを削除します。つまり、ビルドで生成されたすべてのファイルを削除します。

プロジェクトのコンパイル

例

mvn compile

ソースコードをコンパイルし、コンパイル後の class ファイルはtarget/classesディレクトリに配置されます。

テストの実行

例

mvn test

プロジェクト内のすべてのテストケースを実行します。

プロジェクトのパッケージ化

例

mvn package

POM ファイルで指定されたパッケージタイプ(jar、war など)に従ってプロジェクトをパッケージ化します。

ローカルリポジトリへのインストール

例

mvn install

プロジェクトをビルドしてローカル Maven リポジトリにインストールし、他のプロジェクトが依存関係として使用できるようにします。

リモートリポジトリへのデプロイ

例

mvn deploy

最終的なプロジェクトパッケージをリモートリポジトリにコピーし、他の開発者やプロジェクトが使用できるようにします。


依存関係管理コマンド

プロジェクトの依存関係ツリーを表示

例

mvn dependency:tree

プロジェクトの依存関係ツリーを表示し、依存関係の分析や依存関係の競合解決に役立ちます。

ソースコードのダウンロード

例

mvn dependency:sources

プロジェクトが依存するソースコードをダウンロードします。

依存関係の分析

例

mvn dependency:analyze

プロジェクトで使用されているが宣言されていない依存関係と、宣言されているが使用されていない依存関係を分析します。


プロジェクト作成コマンド

シンプルなプロジェクトの作成

例

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

Maven アーキタイプシステムを使用して、シンプルな Java プロジェクトを作成します。

Web プロジェクトの作成

例

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-web-app -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

シンプルな Web アプリケーションプロジェクトを作成します。


その他の便利なコマンド

テストのスキップ

例

mvn install -DskipTests

プロジェクトをビルドしてローカルリポジトリにインストールしますが、テストフェーズはスキップします。

特定のテストを実行

例

mvn test -Dtest=TestClassName

指定されたテストクラスのみを実行します。

例

mvn test -Dtest=TestClassName#testMethodName

指定されたテストクラス内の特定のテストメソッドのみを実行します。

依存関係の更新

例

mvn versions:display-dependency-updates

プロジェクト内のどの依存関係に利用可能な更新バージョンがあるかを確認します。

サイトドキュメントの生成

例

mvn site

さまざまなレポートを含むプロジェクトのサイトドキュメントを生成します。

特定のフェーズを実行

例

mvn clean package

最初に clean ライフサイクルを実行し、次に default ライフサイクルを package フェーズまで実行します。


Maven コマンドの組み合わせ使用

Maven コマンドは効率を上げるために組み合わせて使用できます:

例

mvn clean install

まずプロジェクトをクリーンアップし、次にコンパイル、テスト、ローカルリポジトリへのインストールを実行します。

例

mvn clean package -DskipTests

プロジェクトをクリーンアップし、テストを実行せずにパッケージ化します。


よくある問題の解決

スナップショット依存関係を強制更新

例

mvn clean install -U

-Uパラメータは Maven にリモートリポジトリ内の依存関係の更新バージョンを強制的に確認させます。

オフラインモード

例

mvn -o package

-oパラメータは Maven をオフラインモードで実行させ、ローカルリポジトリ内の依存関係のみを使用します。

デバッグモード

例

mvn -X clean install

-Xパラメータはデバッグ出力を有効にし、詳細な実行情報を表示します。


基本的なビルドコマンド

コマンド機能実行されるライフサイクルフェーズ
mvn clean削除target/ディレクトリclean
mvn validateプロジェクトが正しいか検証するvalidate
mvn compileメインのソースコードをコンパイルするcompile
mvn test-compileテストコードをコンパイルするtest-compile
mvn testユニットテストを実行するtest
mvn packageプロジェクトをパッケージ化するpackage
mvn verify統合テストを実行するverify
mvn installローカルリポジトリにインストールするinstall
mvn deployリモートリポジトリにデプロイするdeploy

典型的な開発フロー:

mvn clean compile test package

依存関係管理コマンド

コマンド機能
mvn dependency:tree依存関係ツリーを表示
mvn dependency:analyze依存関係の問題を分析
mvn dependency:copy-dependencies依存関係をディレクトリにコピー
mvn dependency:purge-local-repositoryローカル依存関係キャッシュをクリア
mvn versions:display-dependency-updates依存関係の更新を確認
# 查看依赖树
mvn dependency:tree

# 检查可用更新
mvn versions:display-dependency-updates

プラグイン関連コマンド

コマンド機能
mvn help:describe -Dplugin=插件名プラグイン情報を表示
mvn help:effective-pom最終的に有効な POM を表示
mvn 插件前缀:目标プラグインターゲットを直接実行
# 查看compiler插件信息
mvn help:describe -Dplugin=compiler

# 直接运行compiler插件的compile目标
mvn compiler:compile

テスト関連コマンド

コマンド機能
mvn testすべてのテストを実行
mvn -Dtest=测试类名 test指定されたテストクラスを実行
mvn -Dtest=测试类名#方法名 test指定されたテストメソッドを実行
mvn -DskipTests=true packageテストをスキップ
# 只运行UserServiceTest类
mvn -Dtest=UserServiceTest test

# 只运行UserServiceTest中的testCreate方法
mvn -Dtest=UserServiceTest#testCreate test

マルチモジュールプロジェクトのコマンド

コマンド機能
mvn -pl 模块名 命令指定されたモジュールに対してコマンドを実行
mvn -am -pl 模块名 命令コマンドを実行し、依存モジュールを処理
mvn -rf 模块名 命令指定されたモジュールから実行を継続
# 只编译service模块
mvn -pl service compile

# 编译web模块及其依赖的模块
mvn -am -pl web compile

高度な使い方

コマンド機能
mvn -T 4 install4つのスレッドを使用して並列ビルド
mvn -o packageオフラインモードで実行
mvn -X clean installデバッグ出力を有効にする
mvn -U clean installsnapshot 依存関係を強制更新
mvn release:prepareプロジェクトのリリース準備
mvn release:performプロジェクトのリリース実行
# 并行构建(4线程)
mvn -T 4 clean install

# 强制更新snapshot依赖
mvn -U clean install

よく使うコマンドの組み合わせ

組み合わせコマンド機能
mvn clean installクリーンアップ後に再インストール
mvn clean package -DskipTestsクリーンアップ後にテストをスキップしてパッケージ化
mvn clean testクリーンアップ後にテストを実行
mvn clean deployクリーンアップ後にデプロイ

実用的なテクニック

プロジェクト情報をすばやく表示:

mvn help:effective-pom
mvn help:describe -Dcmd=compile

ビルド問題のデバッグ:

mvn -X clean install

チェックをスキップ:

mvn install -Dcheckstyle.skip=true -Dpmd.skip=true

プロファイルを指定:

mvn install -P production

ビルド時間を表示:

mvn install --batch-mode | grep "Total time"
その他の拡張