系统要求

在继续教程之前，先确认你的环境满足本章列出的最低要求。

Feat 的设计目标之一是保持轻量，系统要求并不高。生产环境部署时，再根据实际情况调整。

最低要求

项目	要求
JDK	8 或更高
Maven	3.6 或更高
操作系统	任何支持标准 Java 运行时的环境

验证命令：

检查 JDK 和 Maven

java -version
mvn -v

Feat 的主线模块以 Java 8 为编译目标，因此你可以在 JDK 8、11、17、21 等更高版本上运行。如果你要扩展 Feat 或查看源码，需要理解它的 Java 8 兼容边界。

运行环境

Feat 不依赖传统 Servlet 容器。不需要准备 Tomcat、Jetty 或 Undertow，只要有 Java 运行时即可。

更具体地说，运行环境需要满足：

• 能运行普通 Java 应用
• 能打开本机监听端口（默认 8080）
• 能加载项目依赖和资源文件

大多数示例可以直接用 main() 启动：

Bootstrap.java

import tech.smartboot.feat.Feat;

public class Bootstrap {
    public static void main(String[] args) {
        Feat.httpServer()
            .httpHandler(req -> req.getResponse().write("Hello Feat"))
            .listen();
    }
}

各模块的额外要求

不同模块对额外环境的需求不同：

Feat Core

只需要 JDK + Maven + 浏览器或 curl。

验证 Core 示例

curl http://localhost:8080/

Feat Cloud

需要支持 Maven 和注解处理的 IDE（推荐 IntelliJ IDEA）。Feat Cloud 使用编译期注解处理（APT）生成代码，因此 IDE 需要正确配置注解处理器。

Feat AI

需要额外准备模型服务端：

• 本地模型：Ollama 或其他本地推理服务
• 云端 API：OpenAI、Anthropic、Gitee AI 等平台的 API Key

检查 Ollama 是否运行

ollama list

Native Image（可选）

如果你只是想使用 Feat，可以跳过这一部分。只有在你明确准备构建原生镜像时，才需要关注。

建议的使用路径：

1. 先用 JRE 部署跑通 → 2. 确认需要 Native Image → 3. 投入 Native Image 优化

对大多数项目来说，先用 JRE 交付是更稳的路径。Native Image 更适合在你已经确认收益（启动速度、内存占用）之后再投入。

快速自检清单

在继续之前，确认你能完成以下操作：

• 运行 java -version，显示 Java 8 或更高版本
• 运行 mvn -v，显示 Maven 3.6+
• 运行 mvn clean package，成功构建一个 Java 项目
• 能在本机打开一个 HTTP 端口（如 8080）
• 有浏览器、curl 或其他 HTTP 调试工具

确认以上条件后，根据你的目标选择对应教程。