适合人群与前置知识

要点

  • 本知识体系面向有三类人群:前端想写后端、后端想接 AI、独立开发者想做产品
  • 不需要你精通任何特定框架,但需要基本的 JavaScript/TypeScript 能力
  • 如果你完全没写过代码,建议先补 JavaScript 基础再回来
  • 有 Node.js 经验是加分项,但不是必须——边运行时会从头讲起
  • 学习本知识体系的过程中,你会同时建立后端工程和 AI 接入两套心智模型

内容

1. 三类典型读者

本知识体系的设计,主要服务以下三类人群。你可以对照看看自己属于哪一种:

1.1 前端开发者,想写出完整的后端服务

你可能已经能熟练使用 React、Vue 或 Next.js 写前端,但对后端还停留在"会写几个 API 接口"的阶段。

你的典型困惑可能是:

  • "我知道怎么发 fetch 请求,但不确定后端到底怎么处理请求的"
  • "数据库、认证、部署这些东西,每次都靠搜教程临时拼"
  • "想做个独立产品,但后端部分总是感觉不踏实"

本知识体系对你的价值:从 HTTP 基础开始,一路把你带到能独立设计和实现 AI 后端服务的水平。 不是教你调 API,而是帮你理解 API 背后的运行机制。

1.2 后端开发者,想把 AI 能力接进现有系统

你可能已经有扎实的后端经验,熟悉 Express、Spring 或 Go,但对大模型 API、RAG、Agent 编排这些新领域还比较陌生。

你的典型需求可能是:

  • "快速了解 LLM API 的调用方式和流式输出处理"
  • "知道 RAG 的完整链路怎么搭,向量数据库怎么选"
  • "理解 Function Calling 和 Agent 编排的工程实现"

本知识体系对你的价值:Hono 的学习成本对你来说会很低,重点放在 AI 相关章节(11-15、25-27)即可。 前面的基础章节可以快速跳过,但建议至少浏览一下 Web Standards 和边缘部署部分——这可能和你的已有经验不同。

1.3 独立开发者 / 一人公司,想用 AI 做产品

你可能有一定的技术背景,但不一定专精某个方向。你的目标不是"学技术",而是"做出能用的产品"。

你的典型诉求可能是:

  • "我想做一个 AI 产品,但不知道该从哪里开始"
  • "模型 API 会调了,但怎么把它变成一个稳定的服务?"
  • "部署、计费、监控这些东西,每个都要学一遍吗?"

本知识体系对你的价值:提供一条从"有想法"到"产品上线"的完整路径。 特别是阶段四(工程化)和阶段五(部署与产品化)的内容,是独立开发者最容易忽略、但上线后最容易踩坑的地方。

2. 前置知识清单

在开始之前,你需要具备以下基础能力。不需要精通,但至少要熟悉:

能力最低要求建议水平
JavaScript会写函数、对象、数组操作熟悉 ES6+ 语法、Promise、async/await
TypeScript知道类型注解是什么能写 interface、理解泛型基础用法
HTTP知道 GET 和 POST 的区别理解请求头、状态码、JSON 格式
命令行能 cd、ls、mkdir会用 npm/pnpm 安装包和运行脚本
Git知道 clone、commit、push能处理基本的分支和冲突

2.1 如果你是纯前端

你可能已经具备上面所有能力。唯一需要补的是:对"服务端思维"的理解

前端代码运行在浏览器里,环境相对可控;后端代码运行在服务器上,需要考虑并发、状态、安全、持久化。这种思维转换比学一个新框架更重要。

本知识体系的第一阶段(00-04)会帮你建立这种思维。

2.2 如果你完全没写过代码

坦白说,本知识体系不适合作为你的第一份编程教程。

建议先完成以下准备:

  1. 学完 JavaScript 基础(变量、函数、对象、异步)
  2. 能独立写一个简单的前端页面
  3. 了解 HTTP 请求的基本概念

之后再回来,效果会好很多。

3. 不需要你提前知道的东西

有些知识你觉得可能需要,但其实本知识体系会从零讲起:

  • Hono 本身:不需要提前了解,02 分组从零开始
  • 边缘计算 / Serverless:01 分组会讲清楚概念和原理
  • 向量数据库 / Embedding:14 分组会从基础概念讲起
  • Docker / CI/CD:22 分组会覆盖基本用法
  • Prompt 工程:13 分组会系统讲解
注意

你不需要在开始之前"什么都学会"。知识体系存在的意义,就是让你在"还不会"的时候,有地方可以学。

4. 开发环境准备

开始动手之前,你需要准备好以下环境:

4.1 必备工具

# [Node.js](https://nodejs.org) 22+(推荐用 [fnm](https://github.com/Schniz/fnm) 或 [nvm](https://github.com/nvm-sh/nvm) 管理版本)
node -v  # 确认版本号 >= 22
 
# [pnpm](https://pnpm.io)(项目使用 pnpm 作为包管理器)
npm install -g pnpm
 
# 代码编辑器(推荐 [VS Code](https://code.visualstudio.com) 或 [Cursor](https://cursor.sh))
# 安装 ESLint、Prettier、TypeScript 插件

4.2 推荐工具

# Cloudflare CLI(部署到 Workers 时需要)
npm install -g wrangler
 
# HTTP 测试工具(推荐 Bruno 或 httpie)
# 用于手动测试 API 接口

4.3 AI API 密钥

后续章节会用到以下 API 中的至少一个,建议提前注册并获取 API Key:

不需要三个都注册。建议从 Cloudflare Workers AI 开始,因为免费额度最慷慨,而且和本知识体系的部署目标一致。

5. 关于 TypeScript 的说明

本知识体系全程使用 TypeScript。如果你对此有顾虑,这里解释一下为什么:

AI 项目的数据结构特别复杂。 一个典型的 AI API 请求可能包含:

  • 多层嵌套的 message 列表
  • 带类型的 tool_call 参数
  • 动态的 content 结构(text、image_url、tool_use 混排)

如果不用 TypeScript,你只能靠运行时打印日志来排查字段拼错、类型不对这类问题。而 TypeScript 能在你写代码的时候就发现这些错误。

Hono 对 TypeScript 的支持是所有 JS 框架里最好的之一——路由参数、校验结果、中间件上下文,全链路自动推导。这意味着你写一次 schema,运行时校验和编译时类型检查同时生效。

你不需要是 TypeScript 专家。但如果你完全没接触过,建议先花 1-2 小时了解以下概念:

  • 基础类型(string、number、boolean、object)
  • interface 和 type
  • 泛型基础(Array<T>Promise<T>
  • 联合类型(string | number

这些足够你跟完全文。遇到更复杂的类型用法,文中会逐一解释。

6. 总结

本知识体系面向:

  • 想写完整后端的前端开发者
  • 想接入 AI 能力的后端开发者
  • 想用 AI 做产品的独立开发者

前置要求:JavaScript 基础 + TypeScript 基本了解 + HTTP 基本概念。

不需要提前了解 Hono、边缘计算、向量数据库或 Prompt 工程——这些都会从零讲起。

下一篇讲 Hono 在 AI 项目中的角色——帮你理解为什么选 Hono 而不是其他框架,以及它在整个技术栈里处于什么位置。