调研Remix 3、HonoX、Astro、Hono 架构调研
随着 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.yaml15 行、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(纯后端)→ 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 密度」在这里是个假指标——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 友好:先验密度和文档可达性
这是我在这次对比里最意外的维度。先看五个可测指标:
下载量差四个数量级。它是训练语料量的粗代理,不精确,但足以解释「模型凭记忆写这个框架」的成败分布。
真正的非对称在这里: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.txt5.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.tsvs 现在src/content.config.ts)。好在能定位到行。
五、学习曲线:形状比长度重要
形状差异比绝对长度重要得多:
Hono 是低起点、平缓的直线。半小时能上手,之后学多少取决于你造多少结构。
Astro 低起点,但在内容集合和 SSR 处有一个台阶——两级跳,不是一条坡。
HonoX 中起点,天花板低,而且地板会塌(0.x 破坏性变更)。
Remix 3 是高起点陡降:前两三天效率是负的,旧直觉持续误导你;一旦过了,就收敛到「一个包、一条文档链」,不需要再学第三方。
六、两维交叉:只有一格要主动避开
AI 生成正确率高 AI 生成正确率低
曲线短 Hono / Astro ——
曲线长 Remix 3(须配检索) HonoXRemix 3 落在「长曲线 + 高正确率」有个前提:把索引预置给 agent。四条可执行的做法:
Remix 3:AGENTS.md 里写死「先
grep node_modules/remix/INDEX.md,禁止loader/action/hooks」,CI 再加一道grep -r "from 'react'" app/ && exit 1。它自带的 SKILL.md 已经写了这条,别删。Hono:把
llms.txt抓进仓库固定成docs/hono-llms.txt(1.5k tokens),让 agent 每次先读,比凭记忆写可靠得多。Astro:保留生成的 AGENTS.md(它有
astro dev --background这种专为 agent 的后台服务管理),再补一句「内容集合配置在src/content.config.ts」——这是最易过期的点。HonoX:非用不可时,把模板目录树和
_renderer.tsx契约手工贴进 AGENTS.md,因为文档里根本没有,模型只能从模板推。
七、结论
附:怎么复现
# 脚手架(不装依赖,看结构就够)
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 计数。
调研Remix 3、HonoX、Astro、Hono 架构调研
https://dhc.ink/archives/wei-ming-ming-wen-zhang-Ykkoaex2
评论