一、 准备工作
1. 系统要求
- Windows 7/8/10/11
- 至少4GB内存(推荐8GB以上)
- 至少10GB硬盘空间
2.安装JDK
方式:Oracle JDK
- 访问 Oracle官网
- 下载对应操作系统的JDK安装包
- 运行安装程序
3.配置环境变量
Windows系统
-
右键"此电脑" → "属性" → "高级系统设置"
-
点击"环境变量"
-
在系统变量中添加:
JAVA_HOME = C:\Program Files\Java\jdk-17 Path = %JAVA_HOME%\bin
-
验证安装:
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(推荐)
Windows下载 apache-maven-x.x.x-bin.zip即可
-
解压到指定目录
-
配置环境变量:
MAVEN_HOME = C:\apache-maven-3.9.0 Path = %MAVEN_HOME%\bin
-
验证:
mvn -version
Gradle可做备选
6.IDE配置
IntelliJ IDEA配置
- 启动IDEA
- File → Settings → Build → Build Tools → Maven
- 配置Maven home directory
- File → Project Structure → SDKs → 添加JDK路径
二、项目搭建
1.IntelliJ IDEA中创建Maven项目
🚀 方法一:使用IDEA向导创建(推荐)
步骤1:启动创建向导
- 打开IntelliJ IDEA
- 选择 "New Project" 或 "Create New Project"
- 或者使用快捷键:
Ctrl+Shift+Alt+N
(Windows/Linux) 或Cmd+Shift+N
(macOS)
步骤2:选择项目类型
- 在左侧面板选择 "Maven"
- 确保右侧选择了正确的 Project SDK(JDK 17或你安装的版本)
- 如果没有显示JDK,点击 "New..." 添加JDK路径
步骤3:配置Maven设置
- 勾选 "Create from archetype"(可选,用于快速创建特定类型的项目)
- 如果勾选,可以选择:
maven-archetype-quickstart
- 简单的Java项目maven-archetype-webapp
- Web项目
- 不勾选则创建空白Maven项目
步骤4:填写项目信息
GroupId: com.example # 公司或组织标识
ArtifactId: my-first-app # 项目名称
Version: 1.0-SNAPSHOT # 版本号(默认即可)
步骤5:配置Maven环境
- Maven home directory: 选择Maven安装路径
- User settings file: 选择settings.xml文件路径
- Local repository: 本地仓库路径
步骤6:完成创建
- 点击 "Finish"
- 等待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
- File → Open
- 选择刚创建的项目文件夹
- IDEA会自动识别为Maven项目
⚙️ 方法三:创建空Maven项目
步骤1:新建项目
- New Project → Maven
- 不勾选 "Create from archetype"
- 填写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命令:
- 打开右侧 Maven 工具窗口
- 展开项目 → Lifecycle
- 双击命令执行
常用命令:
mvn clean
- 清理target目录mvn compile
- 编译源代码mvn test
- 运行测试mvn package
- 打包项目mvn install
- 安装到本地仓库mvn deploy
- 部署到远程仓库
4 快速创建第一个Java类
步骤1:创建包结构
- 在
src/main/java
下右键 - New → Package →
com.example.app
步骤2:创建主类
-
在包下右键 → New → Java Class
-
输入类名:
HelloWorld
-
添加代码:
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