静态博客框架怎么选：Valaxy、Hexo、VitePress、Hugo、Astro 对比

静态博客框架把 Markdown 文章发布成带列表、标签、归档和主题的站点。这一页比较 Valaxy、Hexo、VitePress、Hugo 和 Astro。

Valaxy 适合你，如果… ​

你要写 Vue 博客，或者要离开 Hexo，并且可以接受新主题。

• 配置和文章都走 Vite 热更新。 见特性。
• 带类型的 valaxy.config.ts 和 site.config.ts。Hexo 用 _config.yml。
• 标签、归档、RSS 和 sitemap 随框架提供。VitePress 为文档打造。见为什么选 Valaxy。
• 主题按 Vue 组件覆盖。 博客用 Yun。同一站点要像文档时用 Press。见自定义组件。
• 先 SSG，再站内跳转。 valaxy build --ssg 为每条路由写一份 HTML。之后的点击不会整页重载。见命令行。
• 完整的中文文档树在 /zh/，文章从 Hexo 的 source/_posts 复制到 pages/posts。见迁移。
• 插件负责评论、搜索和相册。见插件。

pnpm create valaxy

开始。来自 Hexo 时，按迁移并用 Yun。需要 Node.js 22.12 或更新版本。

对比 ​

依据为什么选 Valaxy、开始、特性、命令行和迁移。Hugo 很快是选择 Go 的理由，不是相对 Valaxy 的基准。

决策树 ​

什么时候不选 Valaxy ​

• 某一个 Hexo 主题或插件就是产品，并且不能替换。
• 站点只是一份库手册。用 VitePress。
• 你要 Go 模板，并且这条工具链的构建速度就是要求。本页不发布 Valaxy 与 Hugo 的耗时对比。
• 页面必须混用一种以上的 UI 框架。用 Astro。
• 你需要服务器上的账号。评论是客户端插件，例如 Waline 或 Twikoo。
• Node.js 旧于 22.12。

选择常见问题 ​

Valaxy 和 Hexo 差在哪里？ ​

两者都是博客框架：Markdown 文章、主题、静态构建。对写 Vue 的人，Valaxy 有 Vite 热更新、带类型的 valaxy.config.ts / site.config.ts，以及按 Vue 组件覆盖的主题。Hexo 的中文主题目录仍然更大。可以接受新主题就迁：复制文章，然后用 Yun。只有那个现成主题或插件就是产品时，才留在 Hexo。见迁移。

该用博客框架，还是文档生成器？ ​

站点的主体是文章、标签、归档和博客主题时，用 Valaxy。只有站点就是文档、那些博客部件不是产品时，VitePress 更合适。Press 把文档形态留在 Valaxy 上，包括文章和插件。它不能代替一个独立的库手册去用 VitePress。

SPA 构建和 SSG 有什么区别？ ​

valaxy build 产出单页应用。发布应使用 valaxy build --ssg：每条路由一份 HTML，再由 Vue 注水。之后的跳转更新页面，而不是整页重载。这种站内导航就是和 Astro 默认静态输出的差别，写在为什么选 Valaxy。见命令行。

中文支持做到什么程度？ ​

这个文档站在 /zh/ 维护完整的中文页面，与英文页对应。站点文案使用 Vue i18n，单页也可以用 CSS i18n 放两种语言。Hexo 文章按中文迁移指南搬。Hexo 的主题和插件社区仍然更深。Valaxy 的中文文档是一等的，主题目录没有那么大，所以组件覆盖才重要。

什么时候不该选 Valaxy？ ​

看什么时候不选 Valaxy。短的说法：只在主题锁定时留在 Hexo，库手册用 VitePress，要点是 Go 工具链时用 Hugo，一个站点要混用多种 UI 框架时用 Astro。