系统要求
这篇文档是一张检查表。确认下面的条件满足后,你就可以放心地开始后续教程。
Feat 的设计目标之一是保持轻量,因此它的系统要求并不高。但如果你准备在生产环境使用,还是建议完整阅读本章。
| 项目 | 要求 | 说明 |
|---|---|---|
| JDK | 8 或更高 | 主线模块以 Java 8 为编译目标 |
| Maven | 3.6+ | 用于构建和依赖管理 |
| 操作系统 | 任何支持标准 Java 运行时的环境 | Windows、Linux、macOS 均可 |
JDK 版本说明
Section titled “JDK 版本说明”Feat 的主线模块以 Java 8 为编译目标,这意味着:
- 你可以运行:在 JDK 8、11、17、21 等更高版本上运行 Feat 应用
- 但你应该知道:如果你要扩展 Feat 或查看源码,需要理解它的 Java 8 兼容边界
# 检查你的 JDK 版本java -versionMaven 说明
Section titled “Maven 说明”Feat 的示例工程和文档都默认使用 Maven。如果你习惯 Gradle,理论上也可以工作,但文档中的示例命令都是 Maven 风格。
# 检查 Maven 版本mvn -v运行环境说明
Section titled “运行环境说明”Feat 不依赖传统 Servlet 容器。你不需要准备 Tomcat、Jetty 或 Undertow,直接有 Java 运行时即可。
更具体地说,你的运行环境需要满足:
- 能运行普通 Java 应用
- 能打开本机监听端口(默认 8080)
- 能加载项目依赖和资源文件
这也是为什么大多数示例都能直接用 main() 方式启动:
public class Bootstrap { public static void main(String[] args) { Feat.createServer() .get("/", ctx -> ctx.write("Hello")) .listen(8080); }}各模块的额外要求
Section titled “各模块的额外要求”不同模块对额外环境的需求不一样:
Feat Core
Section titled “Feat Core”只需要 JDK + Maven + 浏览器或 curl。
# 验证 Core 示例curl http://localhost:8080/Feat Cloud
Section titled “Feat Cloud”需要支持 Maven 和注解处理的 IDE(推荐 IntelliJ IDEA)。
Feat AI
Section titled “Feat AI”需要额外准备:
- 本地模型:Ollama 或其他本地推理服务
- 云端 API:OpenAI、Anthropic、Gitee AI 等平台的 API Key
# 检查 Ollama 是否运行ollama listNative Image 要求(可选)
Section titled “Native Image 要求(可选)”如果你只是想使用 Feat,可以跳过这一部分。只有在你明确准备构建原生镜像时,才需要关注。
GraalVM 版本
Section titled “GraalVM 版本”当前文档和示例主要围绕 GraalVM 21 系列展开。
建议的使用路径
Section titled “建议的使用路径”1. 先用 JRE 部署跑通 → 2. 确认需要 Native Image → 3. 投入 Native Image 优化快速自检清单
Section titled “快速自检清单”在继续之前,确认你能完成以下操作:
- 运行
java -version,显示 Java 8 或更高版本 - 运行
mvn -v,显示 Maven 3.6+ - 运行
mvn clean package,成功构建一个 Java 项目 - 能在本机打开一个 HTTP 端口(如 8080)
- 有浏览器、
curl或其他 HTTP 调试工具
满足这些条件后,你就可以开始选择学习路径了。
下一步:根据你的目标选择学习路径
- 从 Feat Core 开始 - 理解底层 HTTP 服务模型
- 从 Feat Cloud 开始 - 快速构建注解式 Web 应用
- 从 Feat AI 开始 - 接入 AI 能力