一、创建 spring boot 项目
1. 新建项目
打开 idea,选择新建项目
2. 基础配置
这里注意下,如果你用的是社区版的 idea,是没有左侧这些选项的,订阅版可以先试用 30 天。
配置项目信息如下:
- name:项目名称(如 demo)
- location:项目存储路径
- language:java
- type:maven(一般都是选 maven)
- group:包名前缀(如 com.example)
- artifact:项目标识(自动填充)
- java version:选择 jdk 11 或 17
- spring boot:选择最新稳定版本(如 3.4.x)
然后点击下一步,选择 spring boot 版本:
3. 选择依赖
在 dependencies 界面搜索并勾选所需依赖,一般项目可以先选择下面这些依赖项:
- spring web:构建 restful api,处理 http 请求和响应。
- spring data jpa:使用关系型数据库进行数据存储和查询。
- thymeleaf:适合 spring 应用的现代模板引擎,支持 html5,提供自然模板,也能在浏览器中直接查看。
- lombok:通过注解自动生成样板代码,减少重复工作,如 getter 和 setter。
- mysql driver:用于连接 mysql 数据库,进行数据存取。
除了上面这些,你还可以添加:
- spring boot devtools:提供开发效率提升功能,如热部署和自动重启。
- spring rest docs:生成基于测试的api文档,帮助维护接口文档。
- spring security:实现安全功能,提供用户认证和授权保护。
- spring data mongodb:如果使用非关系型数据库,提供mongodb支持。
- websocket:支持实时通信功能,适用于实时聊天或问答。
- spring data redis (access + driver):用于集成redis,支持缓存机制提升性能。
- spring boot actuator:监控和管理应用的健康状况和性能指标。
反正根据自己的需求勾选,后续可通过 pom.xml
添加依赖。
4. 生成项目
点击 finish
,idea 自动下载初始依赖并生成项目结构。首次加载可能需 2-5 分钟(依赖下载时间)。
5. 修改 maven 镜像仓库
如果你的 maven 加载过慢,这里有个解决办法,把 maven 的配置文件 settings.xml
中的镜像源替换为阿里的。
<mirror> <id>maven-default-http-blocker</id> <mirrorof>external:http:*</mirrorof> <name>pseudo repository to mirror external repositories initially using http.</name> <url>http://0.0.0.0/</url> <blocked>true</blocked> </mirror>
把上面原有的,替换为下面的:
<mirror> <id>alimaven</id> <name>aliyun maven</name> <url>https://maven.aliyun.com/repository/public</url> <mirrorof>*</mirrorof> <!-- 全部仓库都走阿里云,包括原本的sl-releases --> </mirror>
接着,重写一下 用户设置文件
和 本地仓库
的路径。
如果后续你要添加其他依赖,只需要在 pom.xml
文件中,点击 添加启动器
,然后就可以选择你想要的依赖了
6. 免费版 idea 创建教程
如果你用的是免费社区版的 idea,那么可以选择去 start.spring 官网上创建,这个和在 idea 里面创建是一样的。
具体配置如下图所示:
接着可以在右边选择你要的依赖
选择自己需要用到的即可
最近点击最下面的 create
按钮就创建成功啦
然后把项目包解压缩以后,再用 idea 打开就大功告成了
然后就去修改 maven 仓库等等之类的。
二、项目结构解析
生成的项目目录如下:
engstudy ├── src │ ├── main │ │ ├── java │ │ │ └── com.example.engstudy │ │ │ └── engstudyapplication.java # 启动类 │ │ └── resources │ │ ├── static # 静态资源(css/js) │ │ ├── templates # 模板文件(html) │ │ └── application.properties # 配置文件 │ └── test # 测试代码 ├── pom.xml # maven依赖管理
如下图所示:
三、编写测试接口
1. 创建 controller
在 src/main/java/com.example.engstudy
下新建 hellocontroller.java
package com.example.engstudy; import org.springframework.web.bind.annotation.getmapping; import org.springframework.web.bind.annotation.requestparam; import org.springframework.web.bind.annotation.restcontroller; @restcontroller public class hellocontroller { @getmapping("/hello") public string sayhello(@requestparam(value = "name", defaultvalue = "world") string name) { return "hello " + name + "!"; } }
此时不需要数据库(比如只是写个 hello world 接口),在 src/main/resources/application.properties
文件中添加如下配置,禁用数据源自动配置:
spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.datasourceautoconfiguration
2. 启动应用
打开启动类 engstudyapplication.java
→ 点击右上角绿色箭头(或右键选择 run)。控制台输出如下日志即启动成功:
3. 测试接口
浏览器访问 http://localhost:8080/hello
,页面返回 hello world!
。
四、其他设置
1、配置 mysql 连接
修改 src/main/resources/application.properties
spring.datasource.url=jdbc:mysql://localhost:3306/your_db spring.datasource.username=your_user spring.datasource.password=your_password spring.datasource.driver-class-name=com.mysql.cj.jdbc.driver spring.jpa.hibernate.ddl-auto=update
2、配置日志文件
为了将日志保存到文件中,你可以在 src/main/resources
目录下创建一个 logback-spring.xml
文件,并进行如下配置:
<?xml version="1.0" encoding="utf-8"?> <configuration> <!-- 定义日志文件的保存路径和文件名 --> <property name="log_file" value="${log_file:-${log_path:-${log_temp:-${java.io.tmpdir:-/tmp}}}/spring.log}"/> <!-- 控制台输出 --> <appender name="console" class="ch.qos.logback.core.consoleappender"> <encoder> <pattern>%d{yyyy-mm-dd hh:mm:ss.sss} [%thread] %-5level %logger{36} - %msg%n</pattern> </encoder> </appender> <!-- 文件输出 --> <appender name="file" class="ch.qos.logback.core.rolling.rollingfileappender"> <file>${log_file}</file> <rollingpolicy class="ch.qos.logback.core.rolling.timebasedrollingpolicy"> <!-- 日志文件按天滚动 --> <filenamepattern>${log_file}.%d{yyyy-mm-dd}.gz</filenamepattern> <!-- 保存 30 天的日志 --> <maxhistory>30</maxhistory> </rollingpolicy> <encoder> <pattern>%d{yyyy-mm-dd hh:mm:ss.sss} [%thread] %-5level %logger{36} - %msg%n</pattern> </encoder> </appender> <!-- 根日志记录器 --> <root level="info"> <appender-ref ref="console"/> <appender-ref ref="file"/> </root> </configuration>
3、添加 .gitignore 文件
在你的项目主目录下,为你的 .gitignore
文件添加下面的内容(没有这个文件的话,就创建一个)
help.md target/ .mvn/wrapper/maven-wrapper.jar !**/src/main/**/target/ !**/src/test/**/target/ ### sts ### .apt_generated .classpath .factorypath .project .settings .springbeans .sts4-cache ### intellij idea ### .idea *.iws *.iml *.ipr ### netbeans ### /nbproject/private/ /nbbuild/ /dist/ /nbdist/ /.nb-gradle/ build/ !**/src/main/**/build/ !**/src/test/**/build/ ### vs code ### .vscode/ # 下面是github中的内容 # compiled class file *.class # log file *.log # bluej files *.ctxt # mobile tools for java (j2me) .mtj.tmp/ # package files # *.jar *.war *.nar *.ear *.zip *.tar.gz *.rar # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml hs_err_pid* replay_pid* # 编译产物 *.class *.jar *.war # 构建目录 /target/ /build/ # 日志文件 *.log logs/ # 系统文件 .ds_store thumbs.db
这个主要是你 git 上传的时候,防止一些多余的依赖文件上传到仓库中去。
最后,再给大家推荐一个叫做 spring 中文论坛 的网站,里面有很多教程,不懂的都可以去看看。
到此这篇关于intellij idea2025创建springboot项目的实现步骤的文章就介绍到这了,更多相关idea创建springboot内容请搜索代码网以前的文章或
发表评论