閉じる

VSCodeでJavaの開発環境を構築する手順：JDKの導入から実行設定まで詳しく解説

広告

Visual Studio Code (以下VSCode) は、その軽量さと強力な拡張機能により、現在の開発シーンにおいて欠かせないエディタとなりました。

かつてJavaの開発といえば Eclipse や IntelliJ IDEA といった重量級のIDE (統合開発環境) が主流でしたが、2026年現在、VSCodeのJava拡張機能は非常に成熟しており、エンタープライズ開発から学習用途まで幅広く対応可能です。

本記事では、Java開発をこれから始める方や、他のエディタから移行を検討している方に向けて、JDKの導入からVSCodeでの実行環境構築までの全手順を詳しく解説します。

目次 [ close ]
  1. Java開発環境構築の全体像
  2. ステップ1：JDK (Java Development Kit) のインストール
    1. JDKの選び方とダウンロード
    2. Windowsでの環境変数設定
    3. インストールの確認
  3. ステップ2：VSCodeのインストールと日本語化
    1. 日本語化パックの導入
  4. ステップ3：Java用拡張機能パックの導入
    1. 拡張機能パックに含まれる主なツール
  5. ステップ4：Javaプロジェクトの作成と実行
    1. プロジェクトの新規作成
    2. サンプルコードの記述
    3. プログラムの実行
  6. ステップ5：ビルドツール (Maven/Gradle) の活用
    1. Mavenプロジェクトの作成
  7. ステップ6：デバッグ機能の活用
    1. ブレークポイントの設定
  8. よくあるトラブルと解決策
  9. まとめ

Java開発環境構築の全体像

Javaの開発環境を構築するためには、単にエディタをインストールするだけでは不十分です。

プログラムをコンパイルし、実行するためのエンジンである JDK (Java Development Kit) と、開発効率を高めるためのツール群を揃える必要があります。

VSCodeでJavaを扱う最大のメリットは、必要な機能だけをプラグインとして追加できる柔軟性にあります。

まずは、OSに応じたJDKのインストールから進めていきましょう。

ステップ1：JDK (Java Development Kit) のインストール

Javaプログラムを動かすには、Java Runtime Environment (JRE) だけでなく、開発用ツールセットである JDK が必須です。

2026年時点では、長期サポート版 (LTS) である JDK 21 や、より新しい JDK 25 以降を選択するのが一般的です。

JDKの選び方とダウンロード

JDKにはいくつかの配布元がありますが、一般的には以下のいずれかを選択します。

配布元特徴
Eclipse Adoptium (Temurin)コミュニティベースで信頼性が高く、商用利用も無料で推奨されます。
Oracle JDKオラクル社が提供する公式版。ライセンス条件に注意が必要です。
Microsoft Build of OpenJDKAzureなどのクラウド環境と親和性が高い配布元です。

特にこだわりがなければ、Eclipse Adoptiumの「Temurin」を推奨します。

公式サイトにアクセスし、自身のOS (Windows、macOS、Linux) に合ったインストーラーをダウンロードしてください。

Windowsでの環境変数設定

インストーラーを実行する際、「Set JAVA_HOME variable」や「Add to PATH」という項目にチェックを入れることを忘れないでください。

これを行うことで、コマンドラインからJavaを呼び出すための設定が自動的に完了します。

もし手動で設定する場合は、システム環境変数の JAVA_HOME にJDKのインストールパスを指定し、Path 変数に %JAVA_HOME%\bin を追加します。

インストールの確認

設定が正しく完了したかを確認するために、ターミナル (コマンドプロンプトやPowerShell) を開き、以下のコマンドを入力します。

Shell
java -version

正常にインストールされていれば、以下のような実行結果が表示されます。

text
openjdk version "21.0.x" 202X-XX-XX
OpenJDK Runtime Environment Temurin-21.0.x+x (build 21.0.x+x)
OpenJDK 64-Bit Server VM Temurin-21.0.x+x (build 21.0.x+x, mixed mode, sharing)

ステップ2：VSCodeのインストールと日本語化

次に、エディタ本体であるVSCodeをインストールします。

公式サイト (code.visualstudio.com) からインストーラーを入手してください。

日本語化パックの導入

VSCodeはデフォルトで英語表記ですが、日本語化することができます。

  1. VSCodeを起動し、左側のメニューバーにある Extensions アイコン (四角いマーク) をクリックします。
  2. 検索窓に Japanese と入力します。
  3. Japanese Language Pack for Visual Studio Code をインストールし、右下に表示されるポップアップで Change Language and Restart をクリックします。

これで、メニューが日本語表示になり、操作がスムーズになります。

ステップ3：Java用拡張機能パックの導入

VSCode単体ではJavaの高度な補完やデバッグはできません。

Microsoftが提供している Extension Pack for Java を導入することで、VSCodeが強力なJava開発環境へと進化します。

拡張機能パックに含まれる主なツール

このパックをインストールすると、以下の拡張機能が一括で導入されます。

  • Language Support for Java(TM) by Red Hat: コード補完やエラーチェックを提供します。
  • Debugger for Java: ブレークポイントを使用したデバッグを可能にします。
  • Test Runner for Java: JUnitなどのテストコードを実行します。
  • Maven for Java / Project Manager for Java: プロジェクト管理やビルドツールとの連携を担います。

これらはJava開発において必須級のツールですので、必ずインストールしておきましょう。

ステップ4：Javaプロジェクトの作成と実行

環境が整ったところで、実際にJavaのプログラムを作成してみましょう。

VSCodeでは、単純な1つのファイル実行だけでなく、構造化されたプロジェクトを作成することができます。

プロジェクトの新規作成

  1. Ctrl + Shift + P (macOSは Cmd + Shift + P) を押し、コマンドパレットを開きます。
  2. Java: Create Java Project と入力して選択します。
  3. 今回はシンプルな構成を試すため、No build tools を選択してください。
  4. プロジェクトを保存するフォルダを選択し、プロジェクト名 (例: HelloWorld) を入力します。

サンプルコードの記述

プロジェクトが作成されると、自動的に src フォルダの中に App.java が生成されることがあります。

以下のコードを記述、または確認してください。

Java
public class App {
    public static void main(String[] args) {
        // コンソールにメッセージを表示する
        System.out.println("Java環境の構築に成功しました！");
        
        int result = add(10, 20);
        System.out.println("計算結果: " + result);
    }

    /**
     * 2つの数値を加算するメソッド
     */
    public static int add(int a, int b) {
        return a + b;
    }
}

プログラムの実行

コードを書き終えたら、エディタ上部に表示されている Run ボタンをクリックするか、F5 キーを押します。

実行結果は、下部の「デバッグコンソール」または「ターミナル」に以下のように出力されます。

text
Java環境の構築に成功しました！
計算結果: 30

ステップ5：ビルドツール (Maven/Gradle) の活用

実務レベルの開発では、外部ライブラリの管理やビルドを自動化するために Maven や Gradle といったビルドツールを使用します。

VSCodeはこれらとも高度に連携します。

Mavenプロジェクトの作成

コマンドパレットから Java: Create Java Project を選び、Maven を選択します。

その後、maven-archetype-quickstart を選択することで、標準的なフォルダ構成のプロジェクトが自動生成されます。

pom.xml ファイルに依存関係 (Dependency) を記述するだけで、必要なライブラリが自動的にダウンロードされるため、開発効率が飛躍的に向上します。

VSCodeのサイドバーにある Maven パネルから、ビルドやパッケージングをマウス操作で行うことも可能です。

ステップ6：デバッグ機能の活用

VSCodeでのJava開発を強力にするのが、デバッグ機能です。

ブレークポイントの設定

行番号の左側をクリックすると、赤い点 (ブレークポイント) が表示されます。

この状態で F5 キーを押してデバッグを開始すると、その行でプログラムの実行が一時停止します。

停止中は、左側の「変数」パネルで現在の変数の値を確認したり、「コールスタック」でメソッドの呼び出し順序を追ったりすることができます。

これは、複雑なロジックのバグを見つける際に非常に役立ちます。

よくあるトラブルと解決策

構築中に発生しやすい問題とその対処法をまとめました。

  • Javaの構文エラーが解消されない: VSCode右下のステータスバーにあるJavaアイコンを確認してください。言語サーバーの起動に失敗している場合は、コマンドパレットから Java: Clean Java Language Server Workspace を実行して再起動を試みてください。
  • JDKが見つからないという警告が出る: VSCodeの「設定」から java.jdt.ls.java.home を検索し、インストールしたJDKのパスが正しく指定されているか確認します。
  • 文字化けが発生する: Windows環境では標準出力のエンコーディングが原因で日本語が化けることがあります。settings.json に "terminal.integrated.profiles.windows" の設定を見直すか、ファイルの保存形式を UTF-8 に統一してください。

まとめ

VSCodeを使用したJavaの開発環境構築は、適切なJDKの選択と拡張機能パックの導入によって、非常にスムーズに行うことができます。

Eclipseなどの専用IDEに引けを取らない補完機能、強力なデバッグツール、そして軽量な動作は、モダンなJava開発において大きな武器となります。

最後に、構築の重要ポイントを振り返ります。

  1. 適切なJDK (LTS版推奨) をインストールし、パスを通すこと。
  2. VSCodeに「Extension Pack for Java」を必ず導入すること。
  3. 必要に応じてMavenやGradleなどのビルドツールを活用すること。

一度環境を整えてしまえば、VSCodeはJava以外の言語でも同様の操作感で開発できるため、マルチ言語エンジニアを目指す方にとっても最適な選択肢となるでしょう。

本記事を参考に、ぜひ快適なJava開発ライフをスタートさせてください。

クラウドSSLサイトシールは安心の証です。

URLをコピーしました！