Java开发环境搭建（WIN+IDEA+Maven）

一、 准备工作

1. 系统要求

• Windows 7/8/10/11
• 至少4GB内存（推荐8GB以上）
• 至少10GB硬盘空间

2.安装JDK

方式：Oracle JDK

1. 访问 Oracle官网
2. 下载对应操作系统的JDK安装包
3. 运行安装程序

3.配置环境变量

Windows系统

1. 右键"此电脑" → "属性" → "高级系统设置"
2. 点击"环境变量"
3. 在系统变量中添加：

   JAVA_HOME = C:\Program Files\Java\jdk-17
   Path = %JAVA_HOME%\bin

4. 验证安装：

   java -version
   javac -version

4.安装IDE（集成开发环境）

推荐IDE选择：

IntelliJ IDEA（强烈推荐）

• 社区版：免费，功能完整
• 专业版：付费，更多企业级功能
• 下载地址：The Leading IDE for Professional Java and Kotlin Development

其他的可备选：

（1）Eclipse（老牌选择），完全免费，插件丰富

载地址：Eclipse Downloads | The Eclipse Foundation

（2）Visual Studio Code（轻量级），免费，需要安装Java扩展包，适合轻量级开发

5.安装构建工具

Maven（推荐）

1. 下载：Download Apache Maven – Maven

        Windows下载 apache-maven-x.x.x-bin.zip即可

1. 解压到指定目录
2. 配置环境变量：

   MAVEN_HOME = C:\apache-maven-3.9.0
   Path = %MAVEN_HOME%\bin

3. 验证：

   mvn -version

Gradle可做备选

6.IDE配置

IntelliJ IDEA配置

1. 启动IDEA
2. File → Settings → Build → Build Tools → Maven
3. 配置Maven home directory
4. File → Project Structure → SDKs → 添加JDK路径

二、项目搭建

1.IntelliJ IDEA中创建Maven项目

🚀 方法一：使用IDEA向导创建（推荐）

步骤1：启动创建向导

1. 打开IntelliJ IDEA
2. 选择 "New Project" 或 "Create New Project"
3. 或者使用快捷键：Ctrl+Shift+Alt+N (Windows/Linux) 或 Cmd+Shift+N (macOS)

步骤2：选择项目类型

1. 在左侧面板选择 "Maven"
2. 确保右侧选择了正确的 Project SDK（JDK 17或你安装的版本）
3. 如果没有显示JDK，点击 "New..." 添加JDK路径

步骤3：配置Maven设置

1. 勾选 "Create from archetype"（可选，用于快速创建特定类型的项目）
2. 如果勾选，可以选择：
   • maven-archetype-quickstart - 简单的Java项目
   • maven-archetype-webapp - Web项目
3. 不勾选则创建空白Maven项目

步骤4：填写项目信息

GroupId: com.example        # 公司或组织标识
ArtifactId: my-first-app    # 项目名称
Version: 1.0-SNAPSHOT       # 版本号（默认即可）

步骤5：配置Maven环境

1. Maven home directory: 选择Maven安装路径
2. User settings file: 选择settings.xml文件路径
3. Local repository: 本地仓库路径

步骤6：完成创建

1. 点击 "Finish"
2. 等待IDEA自动下载依赖和构建项目

📁 项目结构说明

创建完成后，项目结构如下：

my-first-app/
├── pom.xml                 # Maven配置文件
├── src/
│   ├── main/
│   │   ├── java/           # Java源代码
│   │   └── resources/      # 资源文件
│   └── test/
│       ├── java/           # 测试代码
│       └── resources/      # 测试资源
└── target/                 # 编译输出目录

🛠️ 方法二：从命令行创建后导入

步骤1：命令行创建

mvn archetype:generate -DgroupId=com.example \
    -DartifactId=my-app \
    -DarchetypeArtifactId=maven-archetype-quickstart \
    -DinteractiveMode=false

步骤2：导入到IDEA

1. File → Open
2. 选择刚创建的项目文件夹
3. IDEA会自动识别为Maven项目

⚙️ 方法三：创建空Maven项目

步骤1：新建项目

1. New Project → Maven
2. 不勾选 "Create from archetype"
3. 填写GroupId、ArtifactId等信息

步骤2：手动创建目录结构

在 src/main 下创建：

• java 文件夹（标记为Sources Root）
• resources 文件夹（标记为Resources Root）

在 src/test 下创建：

• java 文件夹（标记为Test Sources Root）
• resources 文件夹（标记为Test Resources Root）

2.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>my-first-app</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>
    
    <!-- Java版本配置 -->
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</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>
    
    <!-- 构建配置 -->
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.11.0</version>
                <configuration>
                    <source>17</source>
                    <target>17</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

🎯 创建不同类型的Maven项目

1. Web项目

使用 archetype: maven-archetype-webapp

<packaging>war</packaging>

2. Spring Boot项目

使用 archetype: spring-boot-archetype 或者在pom.xml中添加：

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

3. 多模块项目

创建父项目后，在pom.xml中添加：

<packaging>pom</packaging>

<modules>
    <module>module1</module>
    <module>module2</module>
</modules>

3.常用Maven命令（在IDEA中执行）

在IDEA中执行Maven命令：

1. 打开右侧 Maven 工具窗口
2. 展开项目 → Lifecycle
3. 双击命令执行

常用命令：

• mvn clean - 清理target目录
• mvn compile - 编译源代码
• mvn test - 运行测试
• mvn package - 打包项目
• mvn install - 安装到本地仓库
• mvn deploy - 部署到远程仓库

4 快速创建第一个Java类

步骤1：创建包结构

1. 在 src/main/java 下右键
2. New → Package → com.example.app

步骤2：创建主类

1. 在包下右键 → New → Java Class
2. 输入类名：HelloWorld
3. 添加代码：

package com.example.app;

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, Maven World!");
    }
}

5.常见问题解决

1. Maven项目识别问题

• 右键项目 → Add Framework Support → Maven

2. 依赖下载失败

• 刷新Maven项目：点击Maven工具窗口的刷新按钮
• 检查网络连接和镜像配置

3. 编码问题

• 在pom.xml中添加：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

4. Java版本不匹配

• 确保pom.xml中的Java版本与项目SDK一致

5.Maven下载慢

• 配置阿里云镜像：

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

6. 完成验证

当你可以成功运行以下命令时，说明环境搭建完成：

java -version
javac -version
mvn -version
git --version