一. 安装IntelliJ IDEA
-
下载并安装IntelliJ IDEA Ultimate或Community版
2024年最新版IntelliJ IDEA下载安装过程(含Java环境搭建)
二、下载 Maven
-
访问官网下载
打开浏览器,访问 Maven 官方下载页面:
Download Apache Maven – Maven -
选择版本
下载最新的稳定版本(Binary zip archive),例如:
apache-maven-3.8.6-bin.zip
-
解压文件
将下载的 zip 文件解压到本地目录(建议路径简单,如C:\maven
)
三、配置环境变量
-
打开系统属性
-
按
Win + R
,输入sysdm.cpl
回车 -
切换到 高级 选项卡 → 点击 环境变量
-
-
新建系统变量
-
点击 系统变量 下的 新建
-
变量名:
MAVEN_HOME
-
变量值:Maven 解压路径(如
C:\maven\apache-maven-3.8.6
)
-
-
编辑 Path 变量
-
在系统变量中找到
Path
→ 点击 编辑 -
点击 新建,添加:
%MAVEN_HOME%\bin
-
-
验证安装
打开命令提示符(CMD),输入:mvn -version
若显示 Maven 版本信息(如 Apache Maven 3.8.6),则配置成功
具体操作截图如下
四、配置 IDEA 使用本地 Maven
-
打开 IDEA 设置
-
菜单栏:
File
→Settings
(Windows)或IntelliJ IDEA
→Preferences
(Mac)
-
-
配置 Maven 路径
导航到:
Build, Execution, Deployment
→Build Tools
→Maven
-
Maven home path:选择本地 Maven 解压目录(如
C:\maven\apache-maven-3.8.6
) -
User settings file:指定
settings.xml
路径(通常在conf
目录下)
-
-
配置阿里云镜像(可选)
编辑settings.xml
,在<mirrors>
标签内添加:<!-- 本地仓库路径(按需修改) --><localRepository>D:\J2EE\Maven\apache-maven-3.9.9-bin\apache-maven-3.9.9\repository</localRepository><!-- 镜像配置 --><mirrors><!-- 阿里云镜像(主仓库) --><mirror><id>aliyunmaven</id><mirrorOf>*</mirrorOf><name>阿里云公共仓库</name><url>https://maven.aliyun.com/repository/public</url></mirror>
-
五、常见问题解决
-
mvn -version
不生效 -
-
检查环境变量是否配置正确
-
重启 CMD 或 IDEA 使配置生效
-
-
IDEA 无法识别 Maven
-
确保路径中没有中文或特殊字符
-
在 IDEA 中右键项目 →
Maven
→Reimport
-
-
依赖下载慢
-
确认阿里云镜像配置正确
-
尝试关闭防火墙或更换网络
-
六、验证 SpringBoot 创建的三种方式
(一)、IDEA创建SpringBoot项目/通过Maven创建(手动配置依赖)
(1)File → New → Project->java->Maven
(2)选择Maven项目
(3)手动添加SpringBoot依赖到pom.xml
添加依赖可能会报错,检查Maven的IDEA本地配置
修改成如图所示
添加依赖成功
(4)创建启动类 App.java
在 src/main/java
下创建包(如 org.example),然后新建 App.java
:内容如下
package org.example;//替换为实际包名import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@EnableAutoConfiguration
@RestControllerpublic class App {public static void main(String[]args){SpringApplication.run(App.class,args);}@GetMapping("/hello")public String hello(){return "hello,Spring Boot!";}
}
(5) 验证项目结构
确保目录结构如下(符合 Maven 标准):
demo01/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/example/demo/ # 你的包路径 │ │ │ └── App.java # 启动类 │ │ └── resources/ # 配置文件目录(如application.properties) │ └── test/ # 测试代码
(6)运行应用
方式一:通过 IntelliJ IDEA
-
右键点击
App
类 → Run 'App.main()' -
控制台出现以下日志表示成功:
Started App in 20.944 seconds (process running for 1.467)
方式二:通过命令行
mvn spring-boot:run # 使用Spring Boot Maven插件运行
运行发现报错,这是由于 Maven 找到了多个可能的启动类(org.example.Main
和 org.example.App
),但无法确定应该使用哪一个来运行 Spring Boot 应用。
解决方法有
1. 明确指定主启动类
在 pom.xml
中通过 <configuration>
指定主类:
<build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><configuration><mainClass>org.example.App</mainClass> <!-- 明确指定App类为主类 --></configuration></plugin></plugins>
</build>
2. 检查重复的启动类
删除或重命名项目中多余的启动类(如 org.example.Main
),确保只有一个类包含 main
方法。
再次运行
(7)访问默认端点
启动后,Spring Boot 会初始化一个嵌入式 Tomcat 服务器(默认端口 8080
)。
在浏览器访问:
http://localhost:8080
如果看到 Whitelabel Error Page(404),说明服务已启动但未定义路由,接下来可以添加 Controller。这里我先不添加Controller,要学习添加Controller可以移动到后面目录第八点的内容。
(8) 添加测试接口(可选)
修改App.java如下:
package org.example;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@EnableAutoConfiguration
@RestControllerpublic class App {public static void main(String[]args) {SpringApplication.run(App.class, args);}@GetMapping("/hello")public String hello(){return "hello,spring boot";}}
重启应用后访问:
http://localhost:8080/hello
应返回:Hello, Spring Boot!
(9)常见问题排查
-
端口冲突:
如果8080
被占用,在src/main/resources/application.properties
中修改端口:server.port=8081
-
依赖缺失:
确保pom.xml
中已正确引入spring-boot-starter-web
(之前已修复格式问题)。 -
类扫描问题:
App
类必须放在其他类(如Controller
)的上级包中,否则需手动指定扫描路径:@SpringBootApplication(scanBasePackages = "com.example")
(二)、在线创建Spring Boot项目(可选)
在线创建Spring Boot项目是官方提供的一种创建方式,官网地址为
https://start.spring.io/
在页面中将信息填完后,单击GENERATE按钮生成模块并下载到本地,解压后使用IDEA打开该项目即可
打开demo里面内容
通过IDEA打开该项目
(三)、使用Spring Initializer快速创建(可选)
上述创建Spring Boot的两种方式都比较繁琐,而Spring Initializer不但可以生成完整的目录结构,还可以生成一个默认主程序,从而节省时间
生成的项目通常包含以下结构:
项目根目录/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/example/demo/
│ │ │ └── DemoApplication.java # 主启动类
│ │ └── resources/
│ │ ├── static/ # 静态资源(JS/CSS/图片)
│ │ ├── templates/ # 模板文件
│ │ ├── application.properties # 配置文件
│ │ └── application.yml # 另一种配置格式
│ └── test/ # 测试代码
├── .gitignore # Git忽略规则
└── pom.xml # Maven配置文件(或build.gradle)
点击右上角三角形运行,显示如下则运行成功
七、pom.xml中引入thymeleaf依赖,在classpath:/templates/下新建HTML页面
1、在pom.xml文件中引入Thymeleaf依赖
<!-- 在 <dependencies> 部分添加以下内容 -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
完整的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 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>3.2.0</version><relativePath/> <!-- lookup parent from repository --></parent><groupId>org.example</groupId><artifactId>demo4</artifactId><version>0.0.1-SNAPSHOT</version><name>demo4</name><description>demo4</description><url/><licenses><license/></licenses><developers><developer/></developers><scm><connection/><developerConnection/><tag/><url/></scm><properties><java.version>17</java.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency><!-- 在 <dependencies> 部分添加以下内容 --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-thymeleaf</artifactId></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build></project>
2、在classpath:/templates/下新建HTML页面
在每个页面的html文件导入Thymeleaf的空间命名,以获得更好的提示
<html xmlns:th="http://www.thymeleaf.org">
在classpath:/templates/下新建HTML测试页面test.html
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head><meta charset="UTF-8"><title>测试页面</title>
</head>
<body>
<h1 th:text="${message}">默认标题</h1>
<p>状态: <span th:text="${status}">加载中...</span></p>
</body>
</html>
八、添加 Controller
在java文件目录下创建controller.java
代码如下
package org.example.demo4;import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import java.util.Arrays;
import java.util.List;@Controller
public class controller {@GetMapping("/test")public String testPage(Model model) {model.addAttribute("message", "测试成功!");model.addAttribute("status", "SUCCESS");return "test"; // 对应 templates/test.html}
}
点击左上角三角运行,显示如下运行成功
最后在浏览器访问http://localhost:8080/test看到如下界面则成功