使用 IntelliJ 處理 Maven 項目

IntelliJ IDEA 是一個強大的整合開發環境 (集成開發環境) 廣泛用於Java項目開發。Maven是一種軟體專案管理工具，主要用於管理Java項目。本教程將學習如何在IntelliJ IDEA中創建新的Maven項目、處理依賴項以及使用Maven工具。

1. 設置 IntelliJ IDEA 和 JDK

在開始創建 Maven 項目之前，請確保已正確設置。從官網下載並安裝 IntelliJ IDEA。 官方網站 如果您還沒有。另請確認您已安裝 Java 開發工具包 (JDK) 安裝在您的機器上。

1.1 安裝 JDK

要確認您的 JDK 版本，請打開終端並輸入 java -version。如果您看到帶有特定版本的輸出，則表示您已安裝了 JDK。如果沒有，請參考官方 Java 文件下載並安裝最新的 JDK。

1.2 在 IntelliJ IDEA 中配置 JDK

在 IntelliJ IDEA 中添加或配置 JDK 的步驟如下：

1. 打開 IntelliJ IDEA，並轉到 File > Project Structure。
2. 在打開的對話框中，在Platform Settings下，點擊SDKs。
3. 點擊+按鈕，導航到已安裝的 JDK 的位置。
4. 選擇 JDK 文件夾，然後點擊OK。
5. 點擊Apply，然後點擊OK。

2. 創建一個新的 Maven 專案

現在，讓我們開始創建第一個 Maven 專案。

2.1 開始一個新項目

1. 在 IntelliJ IDEA 中，前往 New Project。

   

   IntelliJ IDEA

2. 在打開的對話框中，選擇 Maven 作為建置系統。

   

   新專案

3. 勾選 從原型創建 方框，這將允許您選擇一個 Maven 原型――為您的新專案提供的範本。對於本例，請選擇 maven-archetype-quickstart。

4. 點擊 下一步。

2.2 設定項目中繼資料

在下一個窗口中：

1. 指定 GroupId、ArtifactId 和 Version 來標識您的項目在本地 Maven 存儲庫中的身份。
2. 選擇一個位置來存儲您的項目文件。
3. 點擊 Next，檢查您的 Maven 設置，然後點擊 Finish。

您的新 Maven 項目現在已經創建。! 您會在工具窗口的左側看到專案結構。

2.3 瞭解 pom.xml

每個 Maven 專案都有一個位於專案目錄根目錄的 pom.xml 文件，這是"專案對象模型"的縮寫。這個文件描述了你的專案、其依賴項以及其他屬性。

pom.xml 檔案

這個檔案乍看之下可能很複雜，但其實很簡單。讓我們來分解一下：

1. <modelVersion>：這是此POM使用的項目模型版本。`

2. **`**：項目組的 ID。

3. <artifactId>：文物的ID (專案)。

4. `：此工件的版本 (專案).

5. `：這一部分是用來指定您的專案所需的所有依賴項目。

3. 使用 Maven 管理依賴項

依賴項是您的專案運行所需的外部 Java 庫或模組。這些可能是框架、工具庫或其他您的專案使用的模組。在 Maven 中，這些依賴項在 pom.xml 文件中進行管理和配置。

3.1 添加依赖项

將依赖项添加到您的 Maven 项目涉及在您的 pom.xml 文件中指定它们。让我们通过一个示例来探讨这个过程。 IronPDF 庫，這是一個流行的 Java 庫，用於生成和操作 PDF HTML轉PDF.

添加依賴項的步驟

1. 在 IntelliJ IDEA 中，找到並打開你的 pom.xml 文件。它通常位於你項目根目錄中，並列在 Project 工具窗口中。

2. 在 pom.xml 文件中，尋找 ```` section。這個標籤封裝了專案需要的所有依賴項。

3. 在 ``<dependencies>，新增一個<dependency>在

區塊中，指定你要添加的依賴的groupId、artifactId及version`。

例如，要添加 IronPDF 作為依賴項，你的 pom.xml 應包含：

添加所需資訊後，保存您的`pom.xml`文件。IntelliJ IDEA 與 Maven 組合，將自動識別更改並提示您導入更新。接受此操作，Maven 將在您的本地 Maven 存儲庫中下載並存儲指定的依賴項。

### 3.2 管理依賴關係

在 Maven 中管理依賴關係很簡單。您可以通過修改來添加、更新或刪除依賴關係。<dependencies>在 `pom.xml` 文件的 `<dependencies>部分。
* **添加新依賴性**：請依照上述步驟進行。
* **更新依賴性**：更改相關<dependencies>`版本`<dependency>將 `pom.xml` 檔案中相關的區塊保存。Maven 隨後會下載新版本並相應地更新專案。
* **移除一個依賴項**：只需移除相應的 `<dependency>```將 `pom.xml` 檔案區塊並儲存起來。Maven 會更新項目，且該依賴項將不再可用。

記住，每當你修改 `pom.xml` 檔案時，請務必匯入更改，以便它們生效。透過此過程，Maven 使管理依賴項變得簡單，讓開發人員能夠更專注於編程，而不是項目配置。```

## 4. 探索 Maven 工具視窗和目標

在 IntelliJ IDEA 中，Maven 工具視窗是一個實用功能，讓您可以管理和執行 Maven 命令。有了它的幫助，您可以有效監督 Maven 專案的各個方面，而無需記住或輸入複雜的 Maven 命令。

### 4.1 開啟 Maven 工具視窗

要使用這個功能豐富的工具視窗：

1. 在 IntelliJ IDEA IDE 中導航到 **視圖** 菜單。
2. 從下拉選單中選擇 **工具視窗**。
3. 從出現的列表中點擊 **Maven**。

完成這些步驟後，你會看到 Maven 工具視窗出現在 IDE 的右側。

### 4.2 執行 Maven 目標

Maven 目標代表可在您的專案上執行的任務。這些目標的例子包括 **`clean`**、**`compile`**、**`test`** 和 **`install`**。

![IntelliJ Maven 指南（它如何與 Java PDF 庫一起工作），圖4：目標](/static-assets/pdf/blog/IntelliJ-maven-guide/IntelliJ-maven-guide-4.webp)

**目標**

執行 Maven 目標：

1. 找到 Maven 工具視窗並展開 **Lifecycle** 部分。此部分包含最常見的目標。

2. 右鍵點擊你想要執行的目標，如 **compile**，然後選擇 **Run Maven Build**。IntelliJ IDEA 會執行所選的目標。

## 5. 編譯和運行您的 Maven 項目

在設置好您的 Maven 項目並了解了基本的 Maven 目標後，讓我們開始編譯和運行您的項目。

### 5.1 編譯專案

Maven 的 **compile** 目標負責轉換您的 Java 文件 (.java) 轉換為 Java 虛擬機的格式 (JVM) 可以執行 (.class 檔案). 以下是操作方法：

1. 前往 Maven 工具窗口，展開 **Lifecycle** 部分。

2. 雙擊 **compile**。Maven 將開始處理您的 .java 文件，將它們編譯為 `.class` 文件並存儲在 **target/classes** 目錄中。

### 5.2 執行專案

專案編譯完成後，我們可以執行它：

1. 在專案的工具視窗中，找到專案的根目錄。
2. 右鍵點擊根目錄並導航至 **Run** > **Main**。此動作將開始執行您的專案。

**注意**: **Main** 選項可能因您的專案設置而有所不同。它指的是作為您的應用程式進入點的主要類別。

## 6. 導入和更新 Maven 項目

在使用 Maven 項目的過程中，經常會修改 pom.xml，例如添加或删除依賴項。當你做出這些修改時，IntelliJ IDEA 會提示你導入更改。你也可以設置你的 IDE 自動導入更改，以保持所有内容同步。

### 6.1 手動匯入變更

如果您更喜歡手動控制您的專案何時反映變更，您可以：

1. 進入 Maven 工具視窗。
2. 找到並點擊 **Reimport All Maven Projects** 按鈕。 (具有兩個圓形箭頭的圖標)此操作將根據最新的pom.xml刷新您的專案。

### 6.2 啟用自動導入

如果您希望變更自動反映：

1. 前往 **File** > **Settings** (或 **IntelliJ IDEA** > **偏好設定** 用於 macOS).

2. 從設定中，導航到**建構、執行、部署** > **建構工具** > **Maven** > **匯入**。

3. 勾選**啟用自動匯入**框，然後點擊**確定**。

啟用自動匯入後，每次更改 pom.xml 都會觸發自動匯入，保持專案更新。這個功能在大型專案中特別有助於保持一致性並避免手動重複作業。

## 結論

本文現已涵蓋在 IntelliJ IDEA 中使用 Maven 項目的基礎知識。Maven 是一個強大的工具，可以管理 Java 項目的結構、依賴項和構建過程。將其與 IntelliJ IDEA 結合起來，您將獲得一個強大的環境，可以輕鬆管理複雜的應用程序。

如果您有興趣使用 IronPDF，值得注意的是他們提供一個 [免費試用](licensing)這讓您可以徹底探索和理解其功能，然後再做出購買決定。如果您決定繼續使用，授權許可證價格從 $749 開始。

添加所需資訊後，保存您的`pom.xml`文件。IntelliJ IDEA 與 Maven 組合，將自動識別更改並提示您導入更新。接受此操作，Maven 將在您的本地 Maven 存儲庫中下載並存儲指定的依賴項。

### 3.2 管理依賴關係

在 Maven 中管理依賴關係很簡單。您可以通過修改來添加、更新或刪除依賴關係。<dependencies>在 `pom.xml` 文件的 `<dependencies>部分。
* **添加新依賴性**：請依照上述步驟進行。
* **更新依賴性**：更改相關<dependencies>`版本`<dependency>將 `pom.xml` 檔案中相關的區塊保存。Maven 隨後會下載新版本並相應地更新專案。
* **移除一個依賴項**：只需移除相應的 `<dependency>```將 `pom.xml` 檔案區塊並儲存起來。Maven 會更新項目，且該依賴項將不再可用。

記住，每當你修改 `pom.xml` 檔案時，請務必匯入更改，以便它們生效。透過此過程，Maven 使管理依賴項變得簡單，讓開發人員能夠更專注於編程，而不是項目配置。```

## 4. 探索 Maven 工具視窗和目標

在 IntelliJ IDEA 中，Maven 工具視窗是一個實用功能，讓您可以管理和執行 Maven 命令。有了它的幫助，您可以有效監督 Maven 專案的各個方面，而無需記住或輸入複雜的 Maven 命令。

### 4.1 開啟 Maven 工具視窗

要使用這個功能豐富的工具視窗：

1. 在 IntelliJ IDEA IDE 中導航到 **視圖** 菜單。
2. 從下拉選單中選擇 **工具視窗**。
3. 從出現的列表中點擊 **Maven**。

完成這些步驟後，你會看到 Maven 工具視窗出現在 IDE 的右側。

### 4.2 執行 Maven 目標

Maven 目標代表可在您的專案上執行的任務。這些目標的例子包括 **`clean`**、**`compile`**、**`test`** 和 **`install`**。

![IntelliJ Maven 指南（它如何與 Java PDF 庫一起工作），圖4：目標](/static-assets/pdf/blog/IntelliJ-maven-guide/IntelliJ-maven-guide-4.webp)

**目標**

執行 Maven 目標：

1. 找到 Maven 工具視窗並展開 **Lifecycle** 部分。此部分包含最常見的目標。

2. 右鍵點擊你想要執行的目標，如 **compile**，然後選擇 **Run Maven Build**。IntelliJ IDEA 會執行所選的目標。

## 5. 編譯和運行您的 Maven 項目

在設置好您的 Maven 項目並了解了基本的 Maven 目標後，讓我們開始編譯和運行您的項目。

### 5.1 編譯專案

Maven 的 **compile** 目標負責轉換您的 Java 文件 (.java) 轉換為 Java 虛擬機的格式 (JVM) 可以執行 (.class 檔案). 以下是操作方法：

1. 前往 Maven 工具窗口，展開 **Lifecycle** 部分。

2. 雙擊 **compile**。Maven 將開始處理您的 .java 文件，將它們編譯為 `.class` 文件並存儲在 **target/classes** 目錄中。

### 5.2 執行專案

專案編譯完成後，我們可以執行它：

1. 在專案的工具視窗中，找到專案的根目錄。
2. 右鍵點擊根目錄並導航至 **Run** > **Main**。此動作將開始執行您的專案。

**注意**: **Main** 選項可能因您的專案設置而有所不同。它指的是作為您的應用程式進入點的主要類別。

## 6. 導入和更新 Maven 項目

在使用 Maven 項目的過程中，經常會修改 pom.xml，例如添加或删除依賴項。當你做出這些修改時，IntelliJ IDEA 會提示你導入更改。你也可以設置你的 IDE 自動導入更改，以保持所有内容同步。

### 6.1 手動匯入變更

如果您更喜歡手動控制您的專案何時反映變更，您可以：

1. 進入 Maven 工具視窗。
2. 找到並點擊 **Reimport All Maven Projects** 按鈕。 (具有兩個圓形箭頭的圖標)此操作將根據最新的pom.xml刷新您的專案。

### 6.2 啟用自動導入

如果您希望變更自動反映：

1. 前往 **File** > **Settings** (或 **IntelliJ IDEA** > **偏好設定** 用於 macOS).

2. 從設定中，導航到**建構、執行、部署** > **建構工具** > **Maven** > **匯入**。

3. 勾選**啟用自動匯入**框，然後點擊**確定**。

啟用自動匯入後，每次更改 pom.xml 都會觸發自動匯入，保持專案更新。這個功能在大型專案中特別有助於保持一致性並避免手動重複作業。

## 結論

本文現已涵蓋在 IntelliJ IDEA 中使用 Maven 項目的基礎知識。Maven 是一個強大的工具，可以管理 Java 項目的結構、依賴項和構建過程。將其與 IntelliJ IDEA 結合起來，您將獲得一個強大的環境，可以輕鬆管理複雜的應用程序。

如果您有興趣使用 IronPDF，值得注意的是他們提供一個 [免費試用](licensing)這讓您可以徹底探索和理解其功能，然後再做出購買決定。如果您決定繼續使用，授權許可證價格從 $749 開始。