macos下成功搭建正常工作的本地SpringInitializr全过程

关注

原创 2026-02-09 11:07:12 1k 阅读 AI 写同款· GEO 优化 ›

如何快速搭建一个 Spring Boot 项目？本文介绍如何快速搭建一个 Spring Boot 项目，包括使用 Spring Initializr 创建项目模板、添加代码和进行测试三个部分。阅读详情

系统：MacOS Mojave 10.14.6
开发环境：IDEA 2020.1

刚开始学习SpringBoot，在用IDEA的SpringInitializr创建项目的时候被墨迹的依赖下载速度给折磨的受不了，经过多方搜集资料后我决定搭建一个本地SpringInitializr避免日后受苦，此外网上许多资料都是好久以前的或者当时使用的资源现在已经改名换姓了，就导致在搭建过程中有许多麻烦事，写这篇博客也是记录下搭建本地SpringInitializr最新的流程操作。

第一步：下载源码
下载地址：https://github.com/spring-io/start.spring.io.git
解压后得到start.spring.io-master文件夹。
在终端cd到文件夹路径下，执行
mvn clean install -DskipTests
我补充几个我在这一步过程中遇到的问题以及解决方案：
问题1：
有些文件大小在几M左右，下的又慢，下着下着就报错了；这种建议重新运行命令慢慢下就好
问题2：
当构建到一个名为git-commit-id-plugin的插件时，会报出找不到.git文件的错误，你可以先试着修改start-site文件夹下的pom文件，找到这个插件然后把它的配置修改为如下形式：

<plugin>
	<groupId>pl.project13.maven</groupId>
	<artifactId>git-commit-id-plugin</artifactId>
	<executions>
		<execution>
			<goals>
				<goal>revision</goal>
			</goals>
		</execution>
	</executions>
	<configuration>
		<dotGitDirectory>你的git文件相对于本项目根路径的位置</dotDirectory>
		<useNativeGit>false</useNativeGit>
	</configuration>
</plugin>

修改好后再次运行mvn命令，如果它没报错那自然最好，但如果又报出了Could not complete Mojo execution...这个错误，那我也不知道为啥，因为我就是这样接着报错的，但是可以再次修改上面的配置文件来解决这个新错误

<configuration>
	<!--".git"文件夹未找到时,构建是否失败;若设置true,则构建失败;若设置false,则跳过执行该目标;默认值:true;-->
	<failOnNoGitDirectory>false</failOnNoGitDirectory>
</configuration>

这样让它在找不到.git文件时直接跳过本步骤接着运行就好。
在这里插入图片描述这是我把报错都解决后重新跑了一遍的结果，看着真舒畅

这一阶段让我有印象的需要去查资料的问题应该就这些了，如果你遇到了其他问题欢迎评论区讨论

第二步：安装Spring Boot CLI
1.安装homebrew（如已安装请跳过）
在终端输入brew -v查看自己有没有安装homebrew。
如果终端提示command not found，那说明你没安装，我们先来完成homebrew的安装，如已安装请跳过

在终端中输入以下命令

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

该命令来自https://zhuanlan.zhihu.com/p/111014448。
注：开始运行后，如果你的电脑没装git，它会弹个窗告知你，你可以直接点击弹窗的安装按钮，存在下载失败的情况，如果失败就重新运行上面的命令再安装，我自己是三次才把git安装成功的。
在这里插入图片描述
git安装好后再执行一次上面的命令，然后等待运行完成，最终可以执行brew -v验证下
至此homebrew安装成功。

2.通过brew安装CLI
在终端依次执行以下两个命令

brew tap spring-io/tap
brew install springboot

运行完后可以执行spring --version验证下
CLI安装成功

第三步：启动项目
执行以下命令(CLI必须安装成功)

cd 文件夹下的start-site路径
mvn spring-boot:run

这一阶段我遇到了一个报错Unable to find a single main class from the following candidates[io.spring.start.site.StartApplication, io.spring.start.site.StartApplication 2]
解决的方法是在start-site文件夹下的pom里加入下面的代码

<properties>
	<start-class>io.spring.start.site.StartApplication</start-class>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
</properties>