🚀 零基础也能学会：做出你的第一个 Java 网站后端

别急着装软件。先弄明白"我们要做什么、要用的东西是什么"，后面每一步你才知道自己在干嘛。

0.1 你今天将做出什么

我们要写一个运行在你自己电脑上的小程序。写完之后，在浏览器地址栏输入一个网址，网页上就会显示 Hello World。就这么小，但它是所有网站后端的第一步。

0.2 用"开餐厅"理解后端开发

你天天用手机 App 和网页，它们背后都分两拨人干的活，用餐厅一比喻就懂了：

今天的流程就是：你自己扮演顾客（用浏览器），从 /hello 这个取餐窗口，取到后厨（你写的 Java 程序）做好的一句话。

0.3 认识今天的三位主角

后面还会遇到一位配角 Maven（帮你的项目自动下载现成代码包的"管家"），到第 1 章再细讲。

0.4 怎么使用这份教程（重要）

• 从头到尾按顺序做，不要跳步。每一步都是下一步的地基。
• 每一步做完，对照"✅ 你应该看到"确认再往下走。错一步，后面步步报错，新手最怕这个。
• 遇到报错先别慌。你遇到的 90% 的问题，第 5 章常见问题里都有现成答案，按报错信息对号入座。
• 看不懂的名词，查第 6 章术语表。不用背，混个脸熟即可，用多了自然就懂。
• 教程末尾每个章节有任务清单，做完打个勾，进度会自动保存在浏览器里，关掉网页也不丢。

先学会两个基本功（打开黑窗口、配环境变量），再装 JDK、Maven、IDEA 三样软件。Spring Boot 本身不需要单独安装——它是以"依赖包"的形式被 Maven 自动下载到项目里的。

1.0 新手预备：什么是 cmd？怎么打开它？

cmd（也叫命令行、黑窗口）是 Windows 自带的一个黑色窗口：你打字输入命令、按回车，电脑就执行。装完软件后，我们要用它来"验收"软件装好了没有。

1. 方法一：按键盘上的 Win 键（田字格图标）→ 直接打字输入 cmd → 按回车。
2. 方法二：同时按 Win + R → 弹出小窗口后输入 cmd → 回车。

1.1 安装 JDK 21（让电脑能运行 Java）

Spring Boot 4.x 要求 Java 17 及以上，本教程使用 JDK 21（LTS 长期支持版，最稳定）。

1. 下载：浏览器打开 https://adoptium.net/zh-CN/temurin/releases/（Adoptium Temurin，免费开源，放心用）。在页面上选择：版本 21、操作系统 Windows、架构 x64，下载 .msi 结尾的安装包（Oracle 官方版也可以）。
2. 安装：双击安装包，一路"下一步"。⚠️ 留意安装到哪个目录（默认类似 C:\Program Files\Eclipse Adoptium\jdk-21.x.x），并避免装到含中文或空格的自定义路径，建议就用默认位置，或者像 C:\jdk\21 这样干净的目录。
3. 配置环境变量 JAVA_HOME（告诉整个电脑"Java 装在哪"）：
   • 按 Win 键搜索"环境变量" → 点开"编辑系统环境变量" → 在弹窗右下角点"环境变量(N)…"按钮。
   • 在下半部分"系统变量"区域点 新建(W)…，按下表填写：
   变量名 JAVA_HOME 变量值 C:\Program Files\Eclipse Adoptium\jdk-21.0.x（改成第 2 步记下的实际安装目录）
   • 再在"系统变量"列表里找到 Path → 双击编辑 → 点新建，填入 %JAVA_HOME%\bin → 一路点"确定"保存所有弹窗。
4. 验收：新开一个 cmd（重要！），输入 java -version 后回车：

1.2 安装 Maven（自动帮你下载代码包的管家）

1. 下载：打开 https://maven.apache.org/download.cgi，找到 Binary zip archive，下载文件名类似 apache-maven-3.9.9-bin.zip 的压缩包。
2. 解压：右键 → 全部解压，放到无中文、无空格的目录，例如 C:\Program Files\maven。注意：解压后会多出一层文件夹（如 apache-maven-3.9.9），记住这个最里面那层的路径（判断标准：这层里面能看到 bin 文件夹）。
3. 配置环境变量（方法同 1.1 第 3 步，在"系统变量"里新建）：

4. 验收：新开 cmd，输入 mvn -v，能看到 Apache Maven 3.9.x 和 Java 版本信息即成功。

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>central</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

之后所有依赖都会从阿里云下载。下载下来的包会缓存在 C:\Users\你的用户名\.m2\repository 文件夹里，这叫本地仓库——同一个包只下载一次，以后新项目直接复用。

1.3 安装 IntelliJ IDEA（写代码的软件）

1. 下载：打开 https://www.jetbrains.com/idea/download/，页面往下拉，选 Community Edition（社区版，免费） 下载即可——本教程所有功能它都够用。（Ultimate 付费版是进阶功能，不需要。）
2. 安装：一路下一步。建议勾选"创建桌面快捷方式"方便日后打开，其余保持默认。
3. 装完不用做任何设置——IDEA 会自动识别你刚装好的 JDK 和 Maven。环境配置到此完成 ✅

C:\> java -version
C:\> mvn -v

一个 Spring Boot 项目有固定的文件夹结构和十来个配置文件，手动从零建既麻烦又容易错。所以我们用官方提供的"项目生成器"（Spring Initializr）一键生成骨架，不用手写任何配置。

2.1 方式 A：在 IDEA 里直接新建（推荐，若你的版本支持）

1. 打开 IDEA → 欢迎页点 New Project（新建项目）。
2. 左侧列表选择 Spring Initializr（旧版本叫 Spring Boot；社区版如果没有这一项，用 2.2 的方式 B，效果一样）。
3. 按下面填写（其余保持默认，看不懂的选项不用管）：

   选项	填写	大白话解释
   Group	com.example	"组织名"，习惯用倒着写的域名。新手随便填，不影响运行。
   Artifact	demo	项目名字。最终启动类的类名会是 DemoApplication。
   Type / Language	Maven / Java	用 Maven 管理依赖，用 Java 语言写。
   Packaging	Jar	最终打包成 jar 文件（一个能直接运行的压缩包）。
   JDK / Java	21	选你第 1 章装的 JDK。
   Spring Boot 版本	最新稳定版（或 4.1.x）	别选带 SNAPSHOT 或 M1/M2 字样的（那是半成品测试版）。
   Dependencies（依赖）	勾选 Spring Web	"依赖"= 现成的功能代码包。要写网站接口，Spring Web 是唯一必需项。

4. 点 Create（创建）。首次创建会下载大量依赖，右下角有进度条，可能要几分钟——这是正常的，等它转完。左侧项目树自动展开、没有红色报错，就成功了。

2.2 方式 B：网站生成 zip 再导入（所有版本都通用）

1. 浏览器打开官方生成器网站：https://start.spring.io/
2. 按 2.1 的表格同样填写：Maven / Java / 21，在 ADD DEPENDENCIES 里点开选 Spring Web，然后点 Generate，会下载一个 zip 压缩包。
3. 解压 zip（建议放到好找的地方，如 C:\Users\你\Desktop）。
4. IDEA 里点 Open（不是 New Project）→ 选中解压出来的 demo 文件夹（注意：选文件夹本身，不是里面的某个文件）→ 弹窗点 Trust Project → 等 IDEA 自动识别并下载依赖完成。

2.3 认识生成的项目结构（哪些能看懂，哪些别碰）

十几样东西你暂时只需要关心 3 个，其余全自动生成、不用碰：

• pom.xml —— 购物清单：写着这个项目需要哪些依赖，Maven 照单下载。
• DemoApplication.java —— 开机按钮：整个程序从这里启动。
• application.properties —— 设置面板：端口号、应用名等设置写在这里。

这一章我们开一个"取餐窗口"：浏览器访问 /hello 这个窗口，程序就端出一句话 "Hello World"。只需新建一个 Java 类，不改其他任何文件。

3.0 先搞懂：什么是"接口"？

回想第 0 章的餐厅比喻：接口（Controller，控制器）就是前后端之间的取餐窗口。它规定：访问哪个网址 → 执行哪段代码 → 返回什么结果。今天的接口非常简单——一道菜：

3.1 新建 HelloController 类

1. 在 IDEA 左侧项目树中，找到启动类 DemoApplication.java 所在的包 com.example.demo（就是文件夹图标）→ 右键它 → New → Java Class。
2. 名字输入 HelloController，回车创建。（⚠️ 名字大小写要一模一样。）
3. 把新文件里的内容全部删掉，复制粘贴下面这段代码（每行后面都有中文注释解释作用）：

package com.example.demo;

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

@RestController // ① 告诉 Spring：这是一个"取餐窗口"，负责处理浏览器的请求
public class HelloController {

    @GetMapping("/hello") // ② 窗口号牌：浏览器访问 http://localhost:8080/hello 时，执行下面的方法
    public String sayHello() {
        return "Hello World"; // ③ 端出去的"菜"：这串字会直接显示在网页上
    }
}

3.2 可选：配置端口和应用名

双击打开 src/main/resources/application.properties。这个文件就是"设置面板"，一行一条设置，# 后面是注释：

spring.application.name=demo   # 应用名（只是个名字，不影响运行）
server.port=8080               # 端口。8080 是默认值，通常不用改；想避开冲突可改成 8081

最激动人心的一章。点一下运行按钮，Spring Boot 内置的服务器（Tomcat）就会启动，等你的浏览器来访问。

4.0 先弄懂网址：http://localhost:8080/hello 是什么意思

4.1 在 IDEA 里运行（最常用）

1. 双击打开启动类 DemoApplication.java（就是带 main 方法、"开机按钮"的那个类）。
2. 点 main 方法左边绿色三角 ▶，选 Run 'DemoApplication'（也可以用右上角的绿色三角）。
3. 盯着下方弹出的 Run 控制台，文字会哗哗滚动（正在启动，别慌）。最终出现这两行就是成功了：

4. 打开浏览器（Edge/Chrome 都行），在地址栏输入：

页面显示 Hello World 🎉 —— 恭喜，你的第一个 Spring Boot 项目跑通了！刚才那一瞬间发生的事：浏览器敲你家门（8080 号门）→ 说出暗号 /hello → 你的程序查到这是 HelloController 的活 → 执行 sayHello() → 把 "Hello World" 端出来。

4.2 怎么停止程序

• IDEA 里运行的：点 Run 控制台左上角的红色方块 ■（Stop）。
• 命令行启动的：在那个窗口按 Ctrl + C。
• 注意：程序停止后，浏览器再访问 localhost:8080 会打不开（提示无法访问）——这是正常的，因为"店"已经打烊了。

4.3 命令行方式运行（可选了解）

不用 IDEA 也能跑：在项目根目录（pom.xml 所在的文件夹）的地址栏输入 cmd 回车（快速在当前文件夹打开 cmd 的技巧），然后任选一种：

# 方式一：直接运行（开发时常用）
mvn spring-boot:run

# 方式二：打包成 jar 再运行（以后部署到服务器时用）
mvn package
java -jar target\demo-0.0.1-SNAPSHOT.jar

4.4 改了代码怎么让它生效？

程序运行中，改代码它不会自动更新（店开着的时候菜谱改了，端出去的还是老菜）。两种办法：

• 方式一（最简单）：点红色方块 ■ 停掉 → 再点绿色三角 ▶ 重新运行。
• 方式二（推荐，自动热重启）：用 spring-boot-devtools 依赖（IDEA 新建的 Spring 项目默认自带），改完代码按 Ctrl + F9（Build Project），程序会自动重启加载新代码，不用手动停。

第一次跑项目 90% 的问题都在这下面，先看报错信息里的英文关键词（如 Port、404、encoding），再点开对应条目对号入座。改完配置记得"重启程序/新开窗口"再验证。

cmd 中执行：
netstat -ano | findstr :8080
输出最后一列是 PID（进程编号），例如 12345，然后：
taskkill /PID 12345 /F

不用背。出现在正文里的名词，都能在这张表里找到一句大白话解释。

成品项目由 3 个关键文件组成（new1 项目就是完整示例，可对照检查你的每一步）。

① pom.xml（依赖配置）

Spring Boot 4.x 的依赖命名：Web 开发用 spring-boot-starter-webmvc（旧版 Boot 3.x 叫 spring-boot-starter-web）。用 start.spring.io 生成的话不用手写，此处仅供对照。

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.1.1</version>   <!-- 版本号按需调整 -->
</parent>

<properties>
    <java.version>21</java.version>
</properties>

<dependencies>
    <!-- Web 开发核心依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-webmvc</artifactId>
    </dependency>

    <!-- 开发工具：改代码自动重启 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
        <optional>true</optional>
    </dependency>
</dependencies>

② DemoApplication.java（启动类）

package com.example.demo;

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

@SpringBootApplication // 组合注解：自动配置 + 组件扫描 + 启动配置
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args); // 启动入口
    }
}

③ HelloController.java（第一个接口）

package com.example.demo;

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

@RestController // 取餐窗口
public class HelloController {

    @GetMapping({"/", "/hello"}) // 首页和 /hello 都返回同一句话
    public String sayHello() {
        return "Hello World";
    }
}

④ application.properties（配置文件）

spring.application.name=demo   # 应用名（仅显示用）
server.port=8080               # 服务端口（默认 8080）