Spring Boot Helper 插件不是必须安装的,IntelliJ IDEA 自带 Spring Initializr 已足够创建标准项目;推荐使用原生向导(File → New → Project → Spring Boot),并配置 JDK 17/21、Spring Boot 3.4.x 及阿里云初始化地址以确保成功。

IntelliJ IDEA 默认已集成 Spring Initializr,无需额外安装“Spring Boot Helper”插件也能创建项目;但如果你看到插件推荐,它只是增强体验的辅助工具,不是必需项。
Spring Boot Helper 插件是否必须安装?
不是。IDEA 自带的 Spring Initializr 向导(在 File → New → Project… 中选择 Spring Boot)已足够完成标准项目创建。所谓 “Spring Boot Helper” 插件是第三方扩展,功能与原生向导高度重叠:
- 它不提供原生向导没有的能力(如依赖版本自动对齐、
pom.xml内嵌添加启动器) - 部分旧版插件可能未适配 Spring Boot 3.x + JDK 17/21,反而引发依赖解析失败或新建向导卡死
- IDEA Ultimate 版本自带
Spring Assistant插件(已默认启用),能做依赖分析、配置提示、仓库生成等,比 Helper 更可靠
用原生 Spring Initializr 创建项目的正确步骤
跳过插件,直接走官方路径更稳:
- 打开 IDEA → File → New → Project… → 左侧选
Spring Boot(不是 “Maven” 或 “Empty Project”) -
Project SDK必须选已配置好的 JDK 17 或 21(Spring Boot 3.x 不支持 JDK 8/11) -
Spring Boot版本建议选3.4.x(当前最新稳定版),避免选2.7.x等 EOL 版本 - 依赖页只勾
Spring Web即可起步;其他如Lombok、Spring Data JPA按需添加,别一次性全选 - 点击
Finish后,IDEA 会调用远程https://start.spring.io生成项目结构 —— 此时若卡在 “Downloading metadata…”,大概率是网络问题,可临时切换为国内镜像(见下一条)
创建时卡在 “Downloading metadata” 怎么办?
这是最常被忽略的阻塞点:IDEA 默认调用国外 start.spring.io,国内用户经常超时或返回 403。解决方法是手动指定国内可用的初始化服务地址:
- 进入 Settings → Languages & Frameworks → Spring → Spring Initializr
- 修改
Initializr service URL为:https://start.aliyun.com(阿里云维护,兼容 Spring Boot 3.x) - 保存后重启向导,新建项目将明显提速,且不再因网络中断失败
- 注意:改完 URL 后,首次使用仍需等待缓存更新,不要立刻重试;可先点
Refresh按钮触发元数据拉取
创建后必须立刻做的三件事
项目生成成功 ≠ 可运行。以下操作漏掉任一,后续跑不通:
- 右键点击
pom.xml→ 选择Maven → Reload:强制刷新依赖树,否则@SpringBootApplication可能报红 - 检查
src/main/resources/application.properties是否存在;若想用 YAML,直接重命名为application.yml并确保缩进正确(空格不能用 Tab) - 在启动类(含
@SpringBootApplication的Application.java)中,点击左侧绿色三角形 ▶️ 运行 —— 不要双击、不要右键 Run,IDEA 会自动创建Spring Boot类型的运行配置
真正容易出问题的地方不在创建动作本身,而在于 JDK 版本与 Spring Boot 版本的隐式绑定、网络初始化源的不可靠性、以及创建后未触发 Maven reload 导致的类路径缺失 —— 这些环节没卡住,项目就真的建成了。


















