如何不依赖‘魔法工具’构建Spring应用？及Spring教程代码原理咨询

我完全懂这种“拿着代码复制粘贴但根本摸不着头脑”的挫败感——Spring生态确实太依赖快速启动工具了，新手很容易陷入“知其然不知其所以然”的困境。咱们一步步拆解你的问题：

一、先搞懂那些“魔法代码”到底是什么 #

你看到的那些复制粘贴的代码，基本都是Spring Initializr自动生成的，它本质是一个快速脚手架工具，帮你省略了手动配置项目结构、依赖、基础类的重复工作。举几个核心部分的解释：

• 主类上的@SpringBootApplication：这不是单一注解，是@Configuration（标记类为配置类）、@EnableAutoConfiguration（开启Spring的自动配置，比如引入web starter就自动配置Tomcat和Spring MVC）、@ComponentScan（自动扫描当前包下的Bean）三个注解的组合。
• build.gradle里的spring-boot-starter-web：这是Spring的“starter依赖”，它会自动帮你引入所有web开发需要的底层依赖（Tomcat容器、Spring MVC核心类、Jackson JSON解析器等），不用你一个个手动加。

二、手动构建Spring应用的步骤（不依赖任何“魔法工具”） #

如果你想彻底搞懂底层，完全可以从零开始手动搭建，步骤如下（以Gradle为例）：

1. 创建基础项目结构 #

手动在本地文件夹里创建如下目录：

your-spring-app/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── example/
│   │   │           └── demo/  # 你的包路径
│   │   └── resources/  # 配置文件存放处
└── build.gradle  # 构建脚本

2. 手动编写Gradle构建脚本 #

打开build.gradle，写入以下内容（每一行都有注释解释）：

// 指定Gradle使用的Java版本
plugins {
    id 'java'
    // 引入Spring Boot插件，提供bootRun、bootJar等任务
    id 'org.springframework.boot' version '3.2.0'
    // 引入Spring依赖管理插件，自动管理所有Spring依赖的版本
    id 'io.spring.dependency-management' version '1.1.4'
}

// 项目基本信息
group = 'com.example'
version = '0.0.1-SNAPSHOT'
java.sourceCompatibility = '17'

// 依赖仓库：从Maven中央仓库拉取依赖
repositories {
    mavenCentral()
}

// 项目依赖：手动添加需要的starter
dependencies {
    // web开发核心依赖（包含Tomcat、Spring MVC等）
    implementation 'org.springframework.boot:spring-boot-starter-web'
    // 测试依赖
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

// 测试任务配置
tasks.named('test') {
    useJUnitPlatform()
}

3. 手动编写Spring主类 #

在src/main/java/com/example/demo/下创建DemoApplication.java：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

// 这里也可以手动拆成三个注解：@Configuration + @EnableAutoConfiguration + @ComponentScan
@SpringBootApplication
public class DemoApplication {
    // Spring应用的入口方法：启动Spring容器，加载所有配置和Bean
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

4. 手动编写一个REST接口 #

在同包下创建HelloController.java：

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

// 标记这是一个REST控制器：返回JSON而非视图
@RestController
public class HelloController {
    // 定义GET请求的接口路径
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, no magic here!";
    }
}

5. 手动构建并运行 #

打开命令行，进入项目根目录：

• 运行应用：执行 ./gradlew bootRun（Windows用gradlew.bat bootRun）
• 打包成可执行Jar：执行 ./gradlew build，然后在build/libs/下找到Jar包，用java -jar demo-0.0.1-SNAPSHOT.jar运行

三、关于深入学习Gradle的建议 #

基础教程不够的话，可以重点啃这几个方向：

• 依赖管理：搞懂依赖的传递性（为什么加一个starter会带一堆其他依赖）、implementation和api的区别、如何排除不需要的依赖
• 自定义构建任务：比如自己写一个任务来复制静态资源、或者修改打包后的Jar包结构
• 多模块项目：如果以后做大型项目，学习如何拆分模块、配置模块间的依赖关系
• Gradle生命周期：理解初始化、配置、执行三个阶段的区别，这能帮你搞清楚构建脚本的执行顺序

慢慢来，先把手动构建的流程走一遍，你会发现Spring的“魔法”其实都是基于Java和Spring核心概念的封装，工具只是帮你省了重复劳动而已。

内容的提问来源于stack exchange，提问作者john01dav