Java 匯入機制深度解析：單類型 vs 按需匯入、編譯期解析與最佳實踐

兩種匯入語法

編譯期解析算法差異

單類型：直接定位

import java.io.File;
// 編譯器直接查找：bootstrap/extension/user classpath 下的 java/io/File.class
// 一次查找，確定唯一

按需：排列組合查找

package com.example;
import java.io.*;
import java.util.*;

// 當代碼使用 File 類時，編譯器按優先級搜索：
// 1. 無包名類        → File (無 package 宣告)
// 2. 當前包           → com.example.File
// 3. java.lang.*      → java.lang.File (自動匯入)
// 4. java.io.*        → java.io.File  ← 找到
// 5. java.util.*      → java.util.File (繼續搜索！)
// 6. 其他匯入包...
// 必須搜完所有可能性，確認無衝突才算完成

衝突檢測

import java.awt.*;
import java.util.*;

// 使用 List 時：
// java.awt.List (GUI 元件) vs java.util.List (集合介面)
// 編譯器發現兩個候選 → 編譯錯誤："reference to List is ambiguous"
// 必須改用單類型匯入或完整限定名

效能影響：編譯期 vs 執行期

結論：按需匯入不影響執行效能，僅降低編譯速度（大型專案明顯）。

JDK 原始碼風格：拒絕按需匯入

// java.util.ArrayList 開頭
package java.util;
import java.io.Serializable;
import java.lang.Comparable;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;
import java.util.RandomAccess;
// 明確列出每個依賴

兩大優勢

1. 編譯更快：大型專案節省可觀建構時間
2. 避免命名衝突：如 java.awt.List vs java.util.List、java.sql.Date vs java.util.Date

代價

• import 區塊較長
• IDE 自動管理（Organize Imports）已消除手寫負擔

現代 IDE 最佳實踐

1. 設定自動整理匯入：Save Actions → Organize imports
2. 排除常見衝突包：Settings → Auto Import → Exclude: java.awt.*, java.sql.*
3. 使用完整限定名：針對衝突類（如 java.sql.Date）直接寫全名
4. 靜態匯入慎用：import static java.util.Collections.*; 僅用於普遍常數/工具方法

模組系統 (JDK 9+) 影響

// module-info.java
module com.example {
    requires java.logging;        // 模組級依賴
    requires transitive java.sql; // 可傳遞依賴
    
    // 匯入仍需在 .java 中宣告
    // 但模組未導出的包無法匯入（強封裝）
}

總結

單類型匯入是專業 Java 開發標準：編譯快、無衝突、意圖明確。按需匯入僅適合快速原型、腳本、教學示範。現代 IDE 完全自動化匯入管理，開發者應配置專案統一風格，專注於模組依賴設計而非匯入語法細節。