SpringBoot 官方文档中文版 - 1. 入门指南

前言

最近在看 SpringBoot 的官方文档，写的很清晰，但对于中文的不好的同学，比如我自己，总是遇到不认识的词句，于是乎，我决定把它翻译出来。

此系列，是结合谷歌翻译+有道翻译，以及我英语四级的水平，仅供学习参考，感谢 SpringBoot 官方整理出如此细致的文档。

截止目前，SpringBoot 的最新版本是 2.5.3，Spring 的最新版本是 5.3.9.

翻译出来的目录结构，参考 SpringBoot 的官方文档，选取中间的核心部分。

SpringBoot 官方文档地址：https://docs.spring.io/spring-boot/docs/current/reference/html/index.html

1. SpringBoot 介绍

SpringBoot 帮助您创建可以独立运行的、基于 Spring 的生产级应用程序。我们对 Spring 平台和第三方库有自己的看法，所以您可以从最简单的开始。大多数SpringBoot 应用程序只需要很少的 Spring 配置。

您可以使用 SpringBoot 创建 Java 应用程序，通过使用 Java -jar 或更传统的 war 包进行部署启动。我们还提供了一个运行 spring 脚本的命令行工具。

我们的主要目标是:

• 为所有 Spring 开发提供一个非常快速和广泛可访问的入门体验。

• 要有自己独特的见解，但当需求开始偏离默认值时，要迅速离开。

• 提供大类别项目(如嵌入式服务器、安全性、度量、运行状况检查和外部化配置)中常见的一系列非功能特性。

• 不要代码生成，也不需要 XML 配置。

2. 系统要求

SpringBoot2.5.3 需要 Java 8，兼容并包括 Java 16。SpringFramework5.3.9 或更高版本也是必需的。

构建工具的版本要求:

Servlet 容器

SpringBoot 支持以下嵌入式 servlet 容器:

您还可以将 Spring Boot 应用程序部署到任何 Servlet 3.1+ 兼容的容器中。

3. 安装 SpringBoot

Spring Boot 可以与 Java 开发工具一起使用，也可以作为命令行工具安装。无论哪种方式，您都需要 Java SDK v1.8 或更高版本。在开始之前，您应该使用以下命令检查当前的 Java 安装:

$ java -version

3.1 Java 开发人员的安装说明

您可以以与任何标准 Java 库相同的方式使用 Spring Boot。为此，在类路径中包含适当的 spring-boot-*.jar 文件。Spring Boot 不需要任何特殊的工具集成，所以您可以使用任何 IDE 或文本编辑器。另外，Spring Boot 应用程序没有什么特殊之处，因此您可以像运行其他 Java 程序一样运行和调试 Spring Boot 应用程序。

尽管您可以复制 Spring Boot jar，但我们通常建议您使用支持依赖项管理的构建工具(如Maven或Gradle)。

3.1.1 Maven 安装

Spring Boot 与 Apache Maven 3.3 或更高版本兼容。如果您还没有安装 Maven，可以按照 [Maven .apache.org](Maven .apache.org) 上的说明操作。

在许多操作系统上，Maven 可以与包管理器一起安装。如果你使用 OSX Homebrew，尝试 brew install maven。Ubuntu 用户可以运行 sudo apt-get install maven。使用 Chocolatey 的 Windows 用户可以在一个提升的(管理员)提示符下运行 choco install maven。

译者注：现在使用 IDEA，可以很方便地创建 SpringBoot 项目，不用这么复杂。

Spring Boot 依赖使用 org.springframework.boot groupId。通常，Maven POM 文件继承 spring-boot-starter-parent 项目，并向一个或多个 “starter”声明依赖项。Spring Boot 还提供了一个可选的 Maven 插件来创建可执行的 jar。

3.1.2 Gradle 安装

Spring Boot 与 Gradle 6.8、6.9和7.x兼容。如果你还没有安装 Gradle，你可以按照gradle.org上的说明操作。

Spring Boot 依赖项可以通过使用 org.springframework.boot 组声明。通常，您的项目会向一个或多个 “starter” 声明依赖项。Spring Boot 提供了一个有用的 Gradle 插件，可以用来简化依赖声明和创建可执行 jar。

3.2 Spring Boot CLI 安装

这个用处不大， 暂不翻译。

具体参考官网：https://docs.spring.io/spring-boot/docs/current/reference/html/getting-started.html#getting-started

4. 开发你的第一个 SpringBoot 程序

spring.io 网站包含许多使用 Spring Boot 的入门指南。如果你需要解决一个特定的问题，首先检查那里。

您可以通过 start.spring.io并从依赖项搜索器中选择“Web”启动器来快捷执行以下步骤。这样做将生成一个新的项目结构，以便您可以立即开始编码。更多细节请查看start.spring.io用户指南。

在我们开始之前，打开终端并运行以下命令，以确保您安装了有效的 Java 和 Maven 版本:

$ java -version
java version "1.8.0_102"
Java(TM) SE Runtime Environment (build 1.8.0_102-b14)
Java HotSpot(TM) 64-Bit Server VM (build 25.102-b14, mixed mode)

$ mvn -v
Apache Maven 3.5.4 (1edded0938998edf8bf061f1ceb3cfdeccf443fe; 2018-06-17T14:33:14-04:00)
Maven home: /usr/local/Cellar/maven/3.3.9/libexec
Java version: 1.8.0_102, vendor: Oracle Corporation

SpringBoot 官方文档中文版 - 1. 入门指南

原文：https://www.cnblogs.com/youcoding/p/15047719.html