Skip to content

为什么一个工具站要做成多页静态站 ​

做工具箱的第一天就面临一个选择:所有工具塞进一个 Vue 应用,还是每个工具一个独立页面。

单页应用(SPA)显然更省事:一个 router,一套布局,新增工具只需要加一条路由。但工具箱不是「一个产品」,而是「88 个搜索入口」。这个判断决定了后面的所有实现。

单页方案会丢掉什么 ​

假设 88 个工具共用一个 index.html:

  • 所有页面 title、description、canonical 相同,搜索引擎只能收录一个 URL;
  • 「在线字数统计」「图片压缩到 100KB」「农历转公历」这些长尾词全部没有落地页;
  • 用户分享出去的是 /?tool=word-counter,链接难看,也没有独立的分享卡片;
  • 页面正文要靠 JS 渲染,抓取工具不执行 JS 时看到的是空壳。

这些损失是结构性的,后期补 meta、补 sitemap 都救不回来——因为根本不存在那些 URL。

多页方案换来了什么 ​

每个工具一个目录、一个 index.html:

/text/word-counter/index.html
/text/text-diff/index.html
/image/image-compressor/index.html

于是可以做到:

能力实现
独立标题每页 <title> 来自 seoTitle
独立描述seoDesc + 静态正文
独立分享卡每页自己的 og:title / og:url
结构化数据WebApplication + FAQPage + BreadcrumbList
无 JS 可读服务端生成的正文
细粒度缓存改一个工具只影响一个目录

页面是生成出来的 ​

88 个页面不可能手写,gen-pages.mjs 从数据生成:

js
// src/data/tools/text.js
export default [
  {
    slug: 'word-counter',
    cat: 'text',
    name: '字数统计',
    seoTitle: '在线字数统计 - 中文/英文/标点分开计数',
    seoDesc: '粘贴文本即可统计字数、单词数、标点数与行数。',
    steps: ['把文本粘贴到输入框', '结果实时更新', '可一键复制'],
    faq: [
      { q: '会上传内容吗?', a: '不会,统计在本地完成。' },
    ],
    component: () => import('../../tools/WordCounter.vue'),
  },
]

生成器负责把这份数据变成完整 HTML:head 里的 meta、JSON-LD、正文区的使用步骤与 FAQ、底部的相关工具内链。Vue 只接管 #app 这一小块交互区域。

这样有一个额外好处:即使 JavaScript 加载失败,用户仍然能读到这个工具是干什么的、怎么用。

多页的代价 ​

诚实地说,代价有三个:

  1. 构建变慢。100+ 个 HTML 入口,vite build 需要 1~2 分钟,而单页只要十几秒。
  2. 共享状态变难。页面之间没有共享的客户端状态,收藏、历史记录这类功能要么放 localStorage,要么不做。
  3. 导航重复。每个页面都要重新加载 CSS/JS(虽然有缓存),首屏比 SPA 多几个请求。

对这个站点来说,这三个代价都能接受:构建慢可以等,没有账号体系就不需要共享状态,静态资源有 hash 长缓存。

构建产物的路径整理 ​

Vite 的多页构建会保留 HTML 源文件的目录结构:

pages/text/word-counter/index.html  →  dist/pages/text/word-counter/index.html

但我们想要的 URL 是 /text/word-counter/,所以 postbuild.mjs 把 dist/pages/* 整体上提:

js
for (const entry of fs.readdirSync(pagesDir)) {
  fs.renameSync(path.join(pagesDir, entry), path.join(dist, entry))
}
fs.rmSync(pagesDir, { recursive: true, force: true })

多一步整理,换来干净的 URL 和无需 nginx rewrite 的目录结构。

那手机版为什么又是单页 ​

因为手机版的入口逻辑不同:用户从分享链接进来,在同一个界面里切换工具,不需要为每个工具准备独立 URL。手机版还整段 noindex,不参与搜索竞争。

同一个仓库里,两个前端用不同的架构,判断标准只有一个:这个端需不需要独立的搜索落地页。

  • 电脑版:需要 → 多页;
  • 手机版:不需要 → 单页 + hash 路由。

结论 ​

如果重来一次,我还是会选多页。静态站的多页成本远低于它带来的搜索收益,而且「生成 HTML」这件事一旦做成流水线,新增工具只是往数组里加一个对象。

下一篇写这套流水线里最容易出错的部分:两个前端如何共用一套组件。

记录方案,而不是记录结论。