Javaのimport文を徹底解説｜基本構文・使い方・エラー対策まで初心者にもわかりやすく解説

1. Javaのimport文とは？目的とメリット

2. import文の基本構文と種類

2-1. 単一クラスのimport（推奨）

import java.util.List;

2-2. ワイルドカード（*）による一括import

import java.util.*;

2-3. java.langパッケージの自動import

String message = "こんにちは";
System.out.println(message);

2-4. static import文とは？（応用）

import static java.lang.Math.PI;
import static java.lang.Math.max;

3. よく使うimport文の活用例・サンプル集

3-1. 標準ライブラリのimport例

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("今日の日付: " + today);
    }
}

import java.util.ArrayList;
import java.util.HashMap;

public class Sample {
    public static void main(String[] args) {
        ArrayList<String> list = new ArrayList<>();
        list.add("りんご");
        list.add("バナナ");

        HashMap<String, Integer> map = new HashMap<>();
        map.put("りんご", 100);
        map.put("バナナ", 150);

        System.out.println(list);
        System.out.println(map);
    }
}

3-2. static importを使った便利な例

import static java.lang.Math.PI;
import static java.lang.Math.pow;

public class Circle {
    public static void main(String[] args) {
        double r = 3.0;
        double area = PI * pow(r, 2);
        System.out.println("半径3の円の面積: " + area);
    }
}

3-3. ありがちなエラー例と解決策

// import文を忘れた例
ArrayList<String> list = new ArrayList<>(); // エラーになる

4. 名前の衝突（ネームスペース問題）とその対策

4-1. よくある名前の衝突例

import java.util.Date;
import java.sql.Date; // エラーになる

4-2. 競合時のエラーと具体的な対策

import java.util.Date;

public class Sample {
    public static void main(String[] args) {
        Date utilDate = new Date(); // java.util.Dateを利用
        java.sql.Date sqlDate = new java.sql.Date(utilDate.getTime()); // 完全修飾名で利用
        System.out.println(utilDate);
        System.out.println(sqlDate);
    }
}

4-3. ワイルドカードimportと名前の衝突リスク

• クラス名が重複しやすいパッケージや外部ライブラリを利用する場合は、単一クラスimport＋完全修飾名の組み合わせを意識する。
• チーム開発では「importの方針」を事前に統一しておくと、後々のトラブルを避けやすくなります。

5. import文のベストプラクティス・現場TIPS

5-1. 可読性・メンテナンス性を高める書き方

• 良い例 import java.util.List; import java.util.ArrayList;
• あまり推奨されない例 import java.util.*;

5-2. 不要なimportはこまめに整理しよう

5-3. EclipseやIntelliJ IDEAでのimport整理ショートカット

• Eclipseの場合 Ctrl + Shift + O を押すと、不要なimportが自動で削除され、必要なものだけが残ります。
• IntelliJ IDEAの場合 Ctrl + Alt + O で同様にimport文を整理できます。

5-4. コーディング規約に沿ったimport管理

6. 【FAQ】java importのよくある質問とトラブル解決

Q1. importを使わずにクラスを利用できますか？

Q2. import java.util.* は何が問題？

Q3. static importは初心者にもおすすめ？

Q4. import関連のエラーが出た時の対処法は？

Q5. どのタイミングでimport文を書けばよい？

7. まとめ：import文の正しい使い方を身につけよう