随着 AI 深入化使用,对于架构的调研的维度也应该做出对应的调整,将以目录层级、项目结构性偏向、语法糖占比、AI友好型、学习曲线等 5 个维度;调研Remix 3、HonoX、Astro、Hono架构。

  • 目录层级:有无固定的目录层级?

  • 项目结构性偏向:目录层级,语法糖结构用法等是偏向前端还是后端?

  • 语法糖占比:仅隶属于架构的语法或方法是否过于密集?

  • AI友好:AI对于架构理解熟悉;

  • 学习曲线:人作为审核还是需要一定了解的;

四个候选不是一个层级,这点得先说清:Hono 是路由与中间件层,HonoX、Astro 是元框架,Remix 3 是完整技术栈。层级不同的东西没法二选一,但可以放在同一组判据下测量。

一、目录结构:四种路由范式

看一个框架的目录,本质是在问「路由从哪来」。四个框架给了四种答案。

Hono:没有答案。 脚手架只生成一个文件:

src/index.ts        ← 唯一入口,路由用代码注册
package.json  tsconfig.json  pnpm-workspace.yaml

15 行、1 个源文件,没有 pages/、没有 components/、没有 public/。框架对你的文件系统零意见——这是它的卖点,也是它的空洞。

HonoX:文件即路由,但路由是服务端入口。

app/server.ts        ← createApp(),本质是 Hono 实例
app/client.ts        ← createClient(),浏览器水合引导
app/routes/          ← 文件系统即路由
  index.tsx  _404.tsx  _error.tsx  _renderer.tsx
app/islands/counter.tsx   ← 唯一会被 hydrate 的目录
app/style.css  app/global.d.ts
public/favicon.ico  vite.config.ts  wrangler.jsonc

注意 _renderer.tsx、_404.tsx、_error.tsx 这套下划线约定——它决定了页面外壳长什么样,而这条约定只存在于模板里,README 里没有。

Astro:只有 src/pages 是被保留的。

src/pages/index.astro        ← .ts 放这里就是 API endpoint
src/{components,layouts,styles,content}/   ← 全是约定,可任意重命名
public/  astro.config.mjs

官方原话是「唯一被 Astro 保留的目录是 src/pages/」,其余随便你重组。这种克制换来的是内容站里极高的结构自由度,代价是没有统一骨架。

Remix 3:路由不是文件。 这是最容易看错的一个。

app/routes.ts              ← 路由表契约,生成 typed href,如 routes.home.href()
app/router.ts              ← createRouter + middleware 装配
app/actions/controller.tsx ← controller,请求处理在这里
app/actions/<route>/       ← 嵌套路由各自的 controller
app/actions/public/        ← 浏览器模块:entry.ts + 被 clientEntry 标记的组件
app/actions/document.tsx, home-page.tsx   ← 路由自有的 UI
app/assets.ts              ← 服务端资源管线
server.ts                  ← 自己写 node:http,createRequestListener(router.fetch)
.agents/skills/remix/SKILL.md, AGENTS.md  ← 脚手架自带 agent 说明

Remix 2 那套 app/routes/*.tsx 在这里完全不存在。它自带的 SKILL.md 写得很直白:「不要假设文件路由、生成式路由类型或必需的构建步骤」。拿旧大版本的经验看新版本,会得出方向相反的结论——这是对比框架时最贵的一类错误。

二、结构偏向:偏后端还是偏前端

「偏前端」这种话不说判据就是玄学。我用四条可操作、可 grep 的判据:

判据

Hono

HonoX

Remix 3

Astro

HTML 由谁产出

不管,返回 c.text/json

JSX 服务端渲染

controller 的返回值里渲染

.astro 模板本身

请求入口归谁

app.fetch

app.fetch

自己写的 server.ts

自己的 dev server/adapter

构建产物

无(tsc 即可)

client bundle + worker

不打 bundle,importmap 按需编译

全站静态 HTML

目录里非请求文件占比

0

低

中(UI 与 controller 同层)

高(components/layouts/content)

按「后端 ←→ 前端」排:

Hono(纯后端)→ Remix 3(后端骨架,前端可选)→ HonoX(服务端路由 + 显式前端岛)→ Astro(前端/内容骨架,后端可选)

这里有个必须点破的坑:四者对「前端」的定义根本不同。Astro 的前端是 HTML 和内容;HonoX 的前端是 islands;Remix 3 的前端是被 clientEntry() 标记的组件;Hono 没有前端概念。跨框架直接比「前端代码占比」,等于把四种东西当成一种。

Remix 3 值得单独说一句:它看起来像个前端框架(JSX、组件、CSS-in-JS),但结构上是后端偏好的——入口是 controller,HTML 只是它的一种返回值,全站默认不 hydrate。官方把 Remix Store 从 React Router 7 迁过去的实测结果是「全站只有 13 个组件在浏览器运行,其余全是纯 HTML」。

三、语法糖与框架引用:三种糖,成本差一个数量级

数字是我在四个脚手架上正则数出来的(排除 node_modules):

源文件

行数

框架 import 次数

不同子路径

Remix 3

11

950

21

14(remix/routes、/router、/component、/assets、/middleware/render、/node-fetch-server、/test…)

HonoX

9

101

13

10(honox/factory、/server、/client、/vite、hono/jsx、hono/jsx-renderer…)

Astro

2

21

1

1(astro/config)

Hono

1

15

2

2(hono、@hono/node-server)

「每百行 import 密度」在这里是个假指标——15 行的基数能算出 13.3 这种数。该看的是「不同子路径数」,它约等于「需要学的新概念数」。

但比数量更重要的是糖的品种,三类糖的迁移成本差一个数量级:

第一类:运行时协议糖(最重)。 Remix 3 的 950 行里有 26 个 css({...})、26 个 mix={...}、11 处 handle.props / handle.update(),还有 clientEntry(import.meta.url, fn)、<ImportMap value={importMap} />、createController(routes, { actions: {...} }),以及 declare module 'remix' 做的全局类型增强。

这不是「换个写法的 React」,而是一套新的状态与渲染协议:组件是 setup 函数返回 render 函数,状态是普通变量,改完调 handle.update()。学它等于换心智模型。好处是引用全收在 remix/* 一个包里,边界极清。

第二类:薄封装糖。 HonoX 的 createRoute((c) => c.render(...))、jsxRenderer(...)、<Link>/<Script>,本质是把 Hono 的 middleware 包一层。去掉这层直接写裸 Hono 就能退化——它是四个里唯一「糖可以整层剥掉」的。

第三类:文件格式糖。 Astro 的 --- frontmatter 围栏 + Astro.* 全局 + .astro 组件,与语言无关。换成 React/Vue 组件不需要动目录,只加 client:* 指令。糖最少,因为它们绝大多数是模板和 HTML。

Hono 近乎零糖:只有 (c) => c.text() 这个 context 单参数约定。

四、AI 友好:先验密度和文档可达性

这是我在这次对比里最意外的维度。先看五个可测指标:

周下载量

包内文档

机器可读入口

子路径

脚手架自带 agent 文件

Hono

108,805,821

1 个 README

hono.dev/llms.txt 200(5.9KB 全站索引)

2

无

Astro

11,999,151

3 个 md

无(llms.txt 全 404)

1

AGENTS.md(含 astro dev --background)

Remix 3

83,264

68 个 md:INDEX.md 10.7KB + 15 篇 guide 共 306KB

无 llms.txt,但 docs.remix.run/*.md 直出

14

AGENTS.md + SKILL.md

HonoX

15,914

1 个 README

无

10

无

下载量差四个数量级。它是训练语料量的粗代理,不精确,但足以解释「模型凭记忆写这个框架」的成败分布。

真正的非对称在这里:Remix 3 是唯一把「给模型看」当一等设计的框架。 官方六条设计原则第一条就叫 Model-First——「为 LLM 优化源码、文档、工具和抽象」。它把文档直接塞进 npm 包:244KB 的 tarball 里有 68 个 md,INDEX.md 是检索表,guides/ 下 15 篇编号文档,脚手架还会生成 AGENTS.md 和 SKILL.md,后者写死两条纪律:去 grep node_modules/remix/INDEX.md,以及「不要依赖记忆中的 Remix 2 模式」。

但它同时是四个里先验最差的:8.3 万周下载、发布两周、不是 React。所以它的 AI 友好是条件式的——不配检索就必错,配好了才成立。Hono 和 Astro 反过来:什么都没为 AI 做,但模型早就「会」了,属于生态规模免费带来的友好。

HonoX 是最差组合:先验少(1.6 万)、没有内嵌文档、没有 llms.txt、0.x 版本随时破坏,而最关键的 _renderer.tsx 约定只存在于模板里。模型会渲染出一个没有 <html> 外壳的页面,而且不报错。

上下文成本:一次能不能读完

这才是「AI 友好」最实际的含义。

  • Hono:llms.txt 5.9KB ≈ 1.5k tokens,覆盖全站文档索引。一次读完还能继续干活,四个里唯一做到。

  • Remix 3:全量 306KB ≈ 85–90k tokens,读不完。正确姿势是定向检索:

grep -i 'session' node_modules/remix/INDEX.md   # 10.7KB ≈ 3k tokens
# 命中的 guide 单篇 3–51KB,一次只读一篇

最贵的两篇是 11-files-and-assets.md(44KB)和 05-interactivity.md(42KB)。

  • Astro:文档数百页,AGENTS.md 只给 6 条链接,是「指路」不是「内容」,靠先验加现查。

  • HonoX:README 4KB 之外没有内容,边角问题只能读源码。

会怎么错

比正确率更有用的是错法,因为它决定了你能不能一眼认出幻觉:

  • Remix 3:写成 Remix v2 / React Router——app/routes/*.tsx、loader/action、React hooks、useLoaderData。错得很有特征,好识别。

  • Hono:写成 Express——(req, res) 而不是 (c),res.send() 而不是 return c.text()。改一行就好。

  • HonoX:漏掉 _renderer 契约、islands 放错目录。静默错误,渲染出来看着像页面,但没有水合。

  • Astro:在 .astro 里写 useState;用过期的内容集合路径(旧 src/content/config.ts vs 现在 src/content.config.ts)。好在能定位到行。

五、学习曲线:形状比长度重要

首次可运行

必须理解的概念

拐点

天花板

Hono

1 文件 / 15 行

1(context 函数)

自己开始造结构时

就是你自己

Astro

2 文件 / 21 行

4(文件路由、frontmatter、组件+slots、集成/client 指令)

内容集合 + SSR adapter

中

HonoX

9 文件 / 101 行

6(加 _renderer/_404 约定、islands、双入口、Vite 三插件)

islands 何时水合

低且不稳(0.x 破坏)

Remix 3

11 文件 / 950 行

10+(routes 表、router、controller、actions、clientEntry、mix+Handle、ImportMap、asset server、render middleware)

放下 React 直觉

最高(数据/认证/测试/资产全内置)

形状差异比绝对长度重要得多:

  • Hono 是低起点、平缓的直线。半小时能上手,之后学多少取决于你造多少结构。

  • Astro 低起点,但在内容集合和 SSR 处有一个台阶——两级跳,不是一条坡。

  • HonoX 中起点,天花板低,而且地板会塌(0.x 破坏性变更)。

  • Remix 3 是高起点陡降:前两三天效率是负的,旧直觉持续误导你;一旦过了,就收敛到「一个包、一条文档链」,不需要再学第三方。

六、两维交叉:只有一格要主动避开

              AI 生成正确率高          AI 生成正确率低
曲线短      Hono / Astro                ——
曲线长      Remix 3(须配检索)         HonoX

Remix 3 落在「长曲线 + 高正确率」有个前提:把索引预置给 agent。四条可执行的做法:

  1. Remix 3:AGENTS.md 里写死「先 grep node_modules/remix/INDEX.md,禁止 loader/action/hooks」,CI 再加一道 grep -r "from 'react'" app/ && exit 1。它自带的 SKILL.md 已经写了这条,别删。

  2. Hono:把 llms.txt 抓进仓库固定成 docs/hono-llms.txt(1.5k tokens),让 agent 每次先读,比凭记忆写可靠得多。

  3. Astro:保留生成的 AGENTS.md(它有 astro dev --background 这种专为 agent 的后台服务管理),再补一句「内容集合配置在 src/content.config.ts」——这是最易过期的点。

  4. HonoX:非用不可时,把模板目录树和 _renderer.tsx 契约手工贴进 AGENTS.md,因为文档里根本没有,模型只能从模板推。

七、结论

框架

目录层级

结构性偏向

语法糖占比

AI 友好

学习曲线

综合(等权)

Remix 3

★★★★☆ 路由不在文件里:app/routes.ts 路由表 → app/router.ts 装配 → app/actions/ controller → app/actions/public/ 浏览器模块;根级 server.ts + public/

★★★★★ 后端骨架(controller 优先,默认不 hydrate)6:4

★★☆☆☆ 重:21 次 import / 14 个子路径;26 个 css()、26 个 mix=、11 处 handle.*——运行时协议糖

★★★☆☆ 条件式:包内 68 个 md + INDEX.md(10.7KB) + 自带 SKILL.md,但先验只有 8.3 万周下载;不配检索必错成 Remix v2/React

★★☆☆☆ 高起点陡降:950 行 / 10+ 概念 / 2–3 天;天花板最高

16/25(3.2)★★★☆☆

HonoX

★★★★★ 文件即路由:app/routes/ + _renderer/_404/_error 约定 + app/islands/ 唯一水合区 + server.ts/client.ts 双入口

★★★★☆ 服务端路由 + 显式前端岛 5:5

★★★☆☆ 薄:13 次 / 10 个子路径;createRoute、jsxRenderer 可整层退化为裸 Hono

★☆☆☆☆ 低:1.6 万周下载、无内嵌文档、无 llms.txt、0.x 破坏;错法是静默的

★★★☆☆ 中起点、天花板低且会塌:101 行 / 6 概念 / 1 天

16/25(3.2)★★★☆☆

Astro

★★★☆☆ 仅 src/pages 被保留;components/layouts/content 全是约定;.ts 放进 pages 即 endpoint

★★★☆☆ 前端/内容骨架,后端可选 3:7

★★★★☆ 少:1 次 / 1 个子路径;.astro + --- 围栏——文件格式糖

★★★★☆ 中高:1200 万周下载、脚手架带 AGENTS.md(含 astro dev --background),但 llms.txt 全 404

★★★★☆ 低起点 + 一个台阶:21 行 / 4 概念;半天出站、2 天 SSR

18/25(3.6)★★★★☆

Hono

★★☆☆☆ 无约定:src/index.ts 单入口,路由代码注册,框架对文件系统零意见

★☆☆☆☆ 纯后端 10:0

★★★★★ 近乎零:2 次 / 2 个子路径;只有 (c) context 参数

★★★★★ 高:1.09 亿周下载;llms.txt 5.9KB ≈1.5k tokens 可一次读完全站文档;错法一看就懂

★★★★★ 低起点、平缓:15 行 / 1 概念 / 0.5 小时

18/25(3.6)★★★★☆

附:怎么复现

# 脚手架(不装依赖,看结构就够)
npm create hono@latest hono-app -t nodejs          # 会追问,答 n
npm create hono@latest honox-app -t x-basic        # 会追问,答 n
npm create astro@latest astro-app -- --template minimal --no-install --no-git
npx remix@latest new remix-app                     # npx 报 cacache EACCES 时换缓存目录

实测环境:node 25.9.0,macOS。版本取自各项目 package.json:remix 3.2.0、honox 0.1.61(最新 0.1.62)、hono 4.13.16(最新 4.13.19)、astro 7.4.12。下载量取自 api.npmjs.org,统计周为 2026-11-09 至 11-15。包内文档数来自 npm view <pkg> dist.tarball 解包后的 *.md 计数。