# チュートリアル: 最初の Java アプリケーションをデバッグする

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/idea/llms.txt).

Java アプリケーションを [作成して実行](creating-and-running-your-first-java-application.html)しました。 期待どおりに機能していないことがわかったとします。 たとえば、誤った値を返したり、例外でクラッシュしたりします。 コードにエラーがあるようなので、デバッグする必要があります。

このチュートリアルでは、IntelliJ IDEA デバッガーを使用して Java アプリケーションのロジックエラーを見つけて修正する方法を学びます。

ブレークポイントの設定とデバッグセッションの実行から、コードのステップ実行中にプログラム状態を分析するところまで、基本的なデバッグワークフローを学びます。 その過程で、   デバッグ   ツールウィンドウに慣れ、変数インスペクションとインラインデバッグを使用してプログラムロジックを検証する方法を学びます。

このチュートリアルでは、Java の基本的な知識だけが必要です。 このチュートリアルでは、 [Java 25](https://openjdk.org/projects/jdk/25/)構文を使用します。

## デバッグとは

一般的に、デバッグとは、プログラム内のエラーを検出して修正するプロセスです。

対処することになるエラーにはさまざまな種類があります。 構文エラーなど、コンパイラーによって処理されるため、簡単に検出できるものもあります。 また、スタックトレースを調べることでエラーをすぐに特定できる場合もあり、原因を突き止めるのに役立ちます。

ただし、扱いにくく、見つけて修正するのに長い時間がかかるエラーもあります。 たとえば、プログラムの初期に発生する微妙なロジックエラーは、かなり後まで表面化しない場合があり、原因を整理するのが非常に難しくなります。

ここで  デバッガー が役立ちます。 プログラムの内部動作に関するインサイトを提供することで、バグを効率的に見つけられるツールです。 これは、指定されたポイントで実行を一時停止し、プログラムの状態を分析し、必要に応じて実行をステップごとに進めることで可能になります。 デバッグ中は、すべてを制御できます。 このチュートリアルでは、始めるための基本的なデバッグシナリオについて説明します。

## コードを調べる

簡単なデバッグのケースを試してみましょう。

Procedure: 新規プロジェクトを作成します

1. IntelliJ IDEA を起動してください。

IntelliJ IDEA のホーム画面で、  `新規 | プロジェクト`  をクリックします。 すでにプロジェクトを開いている場合は、メインメニューから  `ファイル | 新規プロジェクト`  を選択します。

2. 新規プロジェクト   リストで、   Java   を選択します。 プロジェクトにお名前を付けます (例:  `AverageFinder` )。

3. Maven   を   ビルドシステム   として選択してください。

4. JDK    リストから、利用可能な最新の Oracle OpenJDK バージョンを選択します。

JDK がコンピューターにインストールされているが、IDE で定義されていない場合は、   JDK を追加   を選択し、JDK ホームディレクトリへのパスを指定します。

必要な JDK がコンピューターにインストールされていない場合は、   JDK のダウンロード   を選択してください。

5. サンプルコードの追加   オプションを選択してください。   作成   をクリックします。

![新しいプロジェクトを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/debug-first-app-creating-new-project-java.png)

その後、IDE が新しいプロジェクトを作成してロードします。

Procedure: コードを書く

1. プロジェクトが作成されたら、   プロジェクト   ツールウィンドウ ( `Alt+1` (Windows), `⌘ 1` (macOS), `⌘ 1` (IntelliJ IDEA Classic (macOS)), `⌘ 1` (macOS System Shortcuts), `Alt+1` (XWin), `Alt+1` (GNOME), `Alt+1` (KDE), `Alt+1` (Emacs), `Alt+1` (Sublime Text), `⌘ 1` (Sublime Text (macOS)), `Ctrl+Alt+L` (Visual Studio), `⌘ ⌥ L` (Visual Studio (macOS)), `Ctrl+1` (NetBeans), `Alt+1` (Eclipse), `Alt+1` (Eclipse (macOS)) ) で  `src | メイン | java | org.example | Main.java`  ファイルを見つけてエディターで開きます。

2. 既存のコードを次のコードサンプルに置き換えます:

```JAVA
void main(String[] args) {
    IO.println("Average finder v0.1");
    double avg = findAverage(args);
    IO.println("The average is " + avg);
}

private static double findAverage(String[] input) {
    double result = 0;
    for (String s : input) {
        result += Integer.parseInt(s);
    }
    return result;
}

```

3. アプリケーションを実行します ( `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS)))。

これで、コマンドライン引数として渡されたすべての値の平均を計算するプログラムができました。

プログラムのコンパイルと実行に課題はありませんが、結果は期待どおりではありません。 たとえば、 [1 2 3

を入力として渡す](#setting-arguments)と、結果は  `6.0`  で、  `2.0`  ではありません。

まず、エラーがどこから発生しているかを考える必要があります。 問題は print ステートメントにはないと考えられます。 おそらく、予期しない結果は  `findAverage`  メソッドから発生しています。 原因を見つけるために、実行時のその動作を調べてみましょう。

## ブレークポイントの設定

バグを調査するには、間違った結果を生成しているコード部分に到達したときにプログラムを一時停止する必要があります。 これは  ブレークポイント を設定することで行います。 ブレークポイントは、状態を調べるためにプログラムが一時停止されるコード行を示します。

Procedure:

* `findAverage`  メソッドが呼び出される行のガターをクリックします。

![ブレークポイント](https://resources.jetbrains.com/help/img/idea/2026.3/debug-first-app-set-breakpoint-java.png)

これで、コード行の横の [ガター](editor-gutter.html)に赤い点が表示されます。 これはブレークポイントです。 プログラムがこの行に到達すると、IntelliJ IDEA デバッガーが実行を一時停止するため、何が起きているかを調べ、この時点でプログラムが正しく動作しているかどうかを確認できます。

## デバッグモードでプログラムを実行する

それでは、デバッグモードでプログラムを起動してみましょう。

プログラムの実行およびデバッグ時に引数を渡す必要があるため、それらを [実行/デバッグ構成](null)に含めましょう。

Procedure:

1. ガターの ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)   実行   アイコンをクリックしてから、   実行構成の変更   を選択します。

![ガターの実行ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/debug-first-app-modify-config-java.png)

2. プログラム引数   フィールドに  `1 2 3`  と入力します。 変更を適用し、ダイアログを閉じます。

![引数は、プログラム引数フィールドに入力されます](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_adding_arguments_java.png)

3. `main`  メソッドの近くにある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)   実行   ボタンをクリックします。 メニューから   デバッグ   を選択します。

![ガターの実行ボタンをクリックすると、実行 / デバッグオプションのメニューが表示されます。](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_debug_java.png)

デバッガーセッションが開始され、指定された引数でプログラムが実行されます。

## プログラムの状態を分析する

デバッガーセッションが開始されると、ブレークポイントに到達するまでプログラムは正常に実行されます。 このとき、IntelliJ IDEA はプログラムを一時停止し、プログラムが中断された行をハイライト表示して、 [デバッグ

ツールウィンドウ](debug-tool-window.html)を表示します。

![デバッグツールウィンドウが表示されます。 ブレークポイントがある行がハイライト表示されます](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_tool_overview_java.png)

ハイライトされた行はまだ実行されていません。 これで、プログラムはあなたからのさらなる指示を待ちます。 中断状態では、プログラムの状態を保持する変数を調べることができます。

`findAverage`  メソッドはまだ呼び出されていないため、  `結果`  などのローカル変数はすべてまだスコープ内にありませんが、  `args`  配列の内容を調べることはできます (  `args`  は  `main`  メソッドのスコープ内にあります)。 変数の内容は、  `args`  が使用されている場所にインラインで表示されます。

![インラインデバッグでは、それぞれの変数が使用されている行に変数値が表示されます](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_analyzing_java.png)

デバッグ   ツールウィンドウの   スレッド & 変数   タブで、現在スコープ内にあるすべての変数に関する情報を取得することもできます。

![変数値は変数パネルに表示されます](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_analyzing_threads_and_variables_panel_java.png)

## プログラムのステップスルー

デバッグ   ツールウィンドウに慣れたところで、  `findAverage`  メソッドにステップインし、その内部で何が起きているかを調べます。

Procedure:

1. メソッドにステップインするには、   デバッグ   ツールウィンドウのツールバーにある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stepInto.svg)   ステップイン   ボタンをクリックするか、 `F7` (Windows), `F7` (macOS), `F7` (IntelliJ IDEA Classic (macOS)), `⌘ ;` (macOS System Shortcuts), `F7` (XWin), `F7` (GNOME), `F7` (KDE), `F7` (Emacs), `F7` (Sublime Text), `F7` (Sublime Text (macOS)), `F11` (Visual Studio), `⌘ F11` (Visual Studio (macOS)), `F7` (NetBeans), `F5` (Eclipse), `F5` (Eclipse (macOS)) を押します。

![デバッグツールウィンドウの上部にあるボタンにステップインする](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_step_into_java.png)

ステップ実行中に実行ポイントをさらに一歩進めたため、エディターのハイライトが別の行に移動します。

2. ステップを続けて、ローカル変数  `結果`  がどのように宣言され、ループの各反復でどのように変更されるかを見てみましょう。 変数  `s`  の値が  `"3"`  になるまで、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stepInto.svg)   ステップイン   をクリックします。

![インラインデバッグは、変数値に関する情報を取得できます](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_step_into_2_java.png)

> **Tip:**
> ステップ実行中に誤って進めすぎ、デバッグプロセスをプログラムの開始位置に戻したい場合は、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.restartDebug.svg)   再実行   ボタン (   デバッグ   ツールウィンドウのツールバー) を使用して、いつでもデバッグセッションを再実行できます。 ステップ実行中のプロセスの詳細と可能な操作については、 [プログラムをステップ実行する](stepping-through-the-program.html)を参照してください。

現在、変数  `s`  には値  `"3"`  が含まれています。 これは  整数 に変換され、現在  `3.0`  の値を持つ  `結果`  に追加されます。 これまでのところエラーはありません。 合計は正しく計算されます。

3. ステップ実行中にさらに二歩進むと  `return`  ステートメントに到達し、省略箇所がわかります。 入力数で割らずに、  `6.0`  の値を持つ  `結果`  を返しています。 これが、誤ったプログラム出力の原因でした。

![結果の値は引数の数で割らずにそのまま返されます](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_step_into_3_java.png)

> **Tip:**
> ステップ実行が終了し、通常どおりプログラムの実行を続行する場合は、 `F9` (Windows), `⌘ ⌥ R` (macOS), `F9` (IntelliJ IDEA Classic (macOS)), `⌃ \` (macOS System Shortcuts), `F9` (XWin), `F9` (GNOME), `F9` (KDE), `F9` (Emacs), `F9` (Sublime Text), `F9` (Sublime Text (macOS)), `F5` (Visual Studio), `F5` (Visual Studio (macOS)), `F5` (NetBeans), `F8` (Eclipse), `F8` (Eclipse (macOS)) を押すか、メインメニューから  `実行 | デバッグアクション | プログラムの再開`  を選択します。

4. エラーを修正しましょう。  `return result;`  行を、正しい計算式を含むコードに置き換えます:

```JAVA
return result / input.length;

```

## デバッガーセッションを停止し、プログラムを再実行する

プログラムが正常に動作することを確認するには、デバッガーセッションを停止してプログラムを再実行します。

Procedure:

1. デバッグ   ツールウィンドウのツールバーで、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg)   停止   をクリックするか、 `Ctrl+F2` (Windows), `⌘ F2` (macOS), `⌘ F2` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ .` (macOS System Shortcuts), `Ctrl+F2` (XWin), `Ctrl+F2` (GNOME), `Ctrl+2` (KDE), `Ctrl+F2` (Emacs), `Ctrl+F2` (Sublime Text), `Ctrl+F2` (Sublime Text (macOS)), `Shift+F5` (Visual Studio), `⇧ F5` (Visual Studio (macOS)), `Shift+F5` (NetBeans), `Ctrl+F2` (Eclipse), `⌘ F2` (Eclipse (macOS)) を押します。

![デバッガーセッションは、デバッグツールウィンドウの左側にある停止ボタンを使用して停止する](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_stopping_debugger_java.png)

2. `main`  メソッドの近くにある ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)   実行   ボタンをクリックします。 メニューから   実行   を選択します。

![ガターの実行ボタンをクリックすると、実行 / デバッグオプションのメニューが表示されます。](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_run_2_java.png)

3. ここでプログラムが正しく機能することを確認します。

![プログラムは現在 2.0 を出力する](https://resources.jetbrains.com/help/img/idea/2026.3/debug_tutorial_verify_java.png)

## 要約

このチュートリアルでは、次の内容を学習しました。

* コードを調べるためにブレークポイントを設定する

* デバッグモードでプログラムを実行する

* デバッガーを使用してプログラム状態を分析する

* プログラムコードをステップ実行してエラーの原因を見つける

## 次のステップ

IntelliJ IDEA で他のタスクを完了する方法については、以下のチュートリアルを参照してください:

* [チュートリアル: Java アプリケーションの実行](run-java-applications.html)

* [チュートリアル: JUnit 入門](junit.html)

* [チュートリアル: IntelliJ IDEA で Git 入門](working-with-git-tutorial.html)

利用可能なチュートリアルの一覧は、 [IntelliJ IDEA チュートリアル](instance-tutorials.html) を参照してください。

## See also

### プロシージャ

[コードのデバッグ](debugging-code.html) [Evaluating Expressions](examining-suspended-program.html#evaluating-expressions) [ブレークポイント](using-breakpoints.html)

### リファレンス

[デバッガー設定ガー設定](settings-debugger.html)

### 外部リンク

[Video tutorials](https://www.jetbrains.com/ja-jp/idea/documentation/video-tutorials.jsp)

