您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 綜合教學

IntelliJ IDEA 2016+ 導入 JAR 包完整圖文教程

編輯：Java 綜合教學

場景

IntelliJ IDEA 與 Eclipse 管理依賴方式不同。IDEA 推薦使用 Maven/Gradle 管理依賴，但手動導入本地 JAR 仍是常見需求（如內部私有庫、未發布到倉庫的第三方庫）。

操作步驟（以 IDEA 2016.1 為例，新版本 UI 微調但邏輯一致）

步驟 1：打開項目結構對話框

菜單欄：File → Project Structure (快捷鍵 Ctrl+Alt+Shift+S)

File -> Project Structure

步驟 2：選擇 Modules 面板

左側列表選 Modules，中間選中目標模塊（通常為主模塊）。

Select Modules

步驟 3：進入 Dependencies 標籤頁

點擊頂部 Dependencies 標籤。
點擊右側 + 號 → 選擇 JARs or directories...。

Dependencies tab Choose JARs or directories

步驟 4：選擇 JAR 文件或目錄

文件選擇框中定位到 JAR 文件（或包含多個 JAR 的目錄），雙擊或點擊 OK。
彈出的「Add Library」對話框中，Scope 通常選 Compile（編譯+運行+打包），測試專用選 Test，運行時容器提供選 Provided。

Select JAR file

步驟 5：確認生效

點擊 Apply / OK 關閉對話框。
左側 Project 視圖 → External Libraries 節點下會出現剛導入的 JAR，展開可見類結構。

External Libraries shows JAR

進階：最佳實踐與避坑

1. 優先使用 Maven/Gradle

<dependency>
    <groupId>com.example</groupId>
    <artifactId>my-lib</artifactId>
    <version>1.0.0</version>
    <scope>system</scope> <!-- 僅本地 JAR 臨時用 -->
    <systemPath>${project.basedir}/libs/my-lib.jar</systemPath>
</dependency>

優勢：版本鎖定、傳遞依賴解析、IDE 自動下載源碼/文檔、CI/CD 友好。

2. 本地 JAR 統一存放

項目根目錄建 libs/ 目錄存放手動 JAR，配合 Maven system 作用域或 Gradle implementation files('libs/xxx.jar')，避免 JAR 分散在各處。

3. 模塊依賴 vs 庫依賴

模塊依賴：依賴當前項目內另一個 Module（Project Structure → Modules → Dependencies → + → Module Dependency）。
庫依賴：全局/項目級共享庫（Project Structure → Libraries → + → Java），可被多模塊復用。

4. 導入後同步

Maven 項目修改 pom.xml 後，點擊右側 Maven 面板的 Reload All Maven Projects 圖標。
Gradle 項目點擊 Refresh Gradle Project。

5. 常見問題

現象	原因	解決
導入後編輯器仍紅字	索引未更新	`File → Invalidate Caches / Restart → Invalidate and Restart`
運行時 ClassNotFoundException	Scope 選錯（如 Test scope 打包不含）	改為 Compile 或 Runtime scope
多模塊項目導入不生效	未選中正確 Module	在 Modules 列表選中目標模塊再添加

總結

IDEA 導入 JAR 核心路徑：File → Project Structure → Modules → Dependencies → + → JARs or directories。但強烈建議遷移到 Maven/Gradle 依賴管理，手動導入僅作為過渡或特殊場景補充。掌握 Scope 概念、模塊依賴區別、緩存失效處理，能解決 90% 的依賴配置問題。