IDEA+Maven怎么實現簡單的demo

# IDEA+Maven怎么實現簡單的demo

## 前言

在Java開發中，IntelliJ IDEA作為一款強大的集成開發環境，配合Maven這一優秀的項目構建工具，能夠極大提升開發效率。本文將詳細介紹如何使用IDEA和Maven從零開始構建一個簡單的Java Demo項目，涵蓋環境準備、項目創建、依賴管理、代碼編寫到最終運行的完整流程。

---

## 環境準備

### 1. 安裝JDK
- 推薦JDK 8或以上版本
- 配置JAVA_HOME環境變量
- 終端驗證：`java -version`

### 2. 安裝IntelliJ IDEA
- 下載Community（免費版）或Ultimate版
- 建議版本：2021.x或更高
- 安裝時勾選"Add launchers dir to the PATH"

### 3. 安裝Maven
- 下載地址：https://maven.apache.org
- 解壓后配置MAVEN_HOME和PATH
- 驗證安裝：`mvn -v`

---

## 創建Maven項目

### 1. 新建項目
1. 打開IDEA → New Project
2. 選擇左側"Maven"模板
3. 勾選"Create from archetype"
4. 選擇`maven-archetype-quickstart`
5. 點擊Next

### 2. 配置項目信息
```properties
GroupId: com.example
ArtifactId: demo-project
Version: 1.0-SNAPSHOT

• 確認Maven home路徑
• 設置項目存儲位置
• 點擊Finish完成創建

3. 項目結構說明

demo-project/
├── src/
│   ├── main/
│   │   ├── java/      # 主代碼目錄
│   │   └── resources/ # 資源文件
│   └── test/
│       ├── java/      # 測試代碼
│       └── resources/
├── pom.xml            # Maven核心配置文件
└── target/           # 編譯輸出目錄

理解pom.xml

基礎配置示例

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>demo-project</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!-- 示例：添加JUnit依賴 -->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.13.2</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

關鍵元素說明

• dependencies: 管理項目依賴
• build: 配置構建插件
• repositories: 自定義倉庫地址

編寫Demo代碼

1. 創建主類

在src/main/java下新建com.example.demo.App.java:

package com.example.demo;

public class App {
    public static void main(String[] args) {
        System.out.println("Hello Maven!");
        Calculator calculator = new Calculator();
        System.out.println("3 + 5 = " + calculator.add(3, 5));
    }
}

2. 添加工具類

創建src/main/java/com/example/demo/Calculator.java:

package com.example.demo;

public class Calculator {
    public int add(int a, int b) {
        return a + b;
    }
    
    public int subtract(int a, int b) {
        return a - b;
    }
}

3. 編寫單元測試

在src/test/java下創建測試類：

package com.example.demo;

import org.junit.Test;
import static org.junit.Assert.*;

public class CalculatorTest {
    @Test
    public void testAdd() {
        Calculator calc = new Calculator();
        assertEquals(8, calc.add(3, 5));
    }
}

項目構建與運行

1. Maven常用命令

• 編譯項目：mvn compile
• 運行測試：mvn test
• 打包項目：mvn package
• 清理target：mvn clean
• 安裝到本地倉庫：mvn install

2. 在IDEA中運行

1. 右鍵App.java → Run ‘App.main()’
2. 或使用頂部工具欄運行按鈕
3. 查看控制臺輸出結果

3. 構建可執行JAR

修改pom.xml添加maven-assembly-plugin:

<build>
    <plugins>
        <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <version>3.3.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>com.example.demo.App</mainClass>
                    </manifest>
                </archive>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

執行打包命令：

mvn clean package

運行生成的JAR：

java -jar target/demo-project-1.0-SNAPSHOT-jar-with-dependencies.jar

常見問題解決

1. 依賴下載失敗

• 檢查網絡連接
• 嘗試更換Maven鏡像源
• 手動刪除本地倉庫中對應依賴重新下載

2. 編譯版本不匹配

確保pom.xml中配置正確的JDK版本：

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

3. 找不到主類

• 檢查manifest配置是否正確
• 確認類路徑沒有錯誤
• 使用mvn clean package重新打包

擴展實踐

1. 添加日志功能

引入Log4j2依賴：

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>2.17.1</version>
</dependency>

2. 使用Spring Boot框架

修改pom.xml：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.6.3</version>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

3. 多模塊項目

創建父pom.xml管理子模塊：

<modules>
    <module>demo-core</module>
    <module>demo-web</module>
</modules>

結語

通過本文的步驟，您已經完成了： 1. IDEA+Maven環境配置 2. 標準Maven項目創建 3. 基礎代碼開發與測試 4. 項目構建與打包 5. 常見問題解決方案

建議進一步探索： - Maven生命周期詳解 - 依賴范圍(scope)的使用 - 多環境profile配置 - 自定義Archetype模板

完整的示例代碼已托管至GitHub：示例倉庫鏈接 “`

注：實際使用時請將示例中的包名、GitHub鏈接等替換為您自己的實際內容。本文檔格式為Markdown，可直接保存為.md文件使用。