跳到正文
<-- 回到文竹林

把博客用 Nuxt 重写了一遍

旧版是 Vue3 + Vite 的单页应用,够用,但每次首屏都要等一包 JS 下载完才看得见字。这回换成 Nuxt 4,目标是首屏能直接读到内容。

为什么换

三个理由,按重要程度排:

  1. 首屏白屏太久了,尤其是手机上
  2. 想给搜索引擎和社交平台一个像样的分享卡片
  3. 顺手把多语言做掉,之前一直是硬编码中文

技术选型

  • Nuxt 4 —— 文件路由 + 服务端渲染,SSG 也能出
  • Tailwind v4 —— 用 CSS-first 的 @theme 管设计变量
  • SCSS —— 复杂一点的排版还是写在样式块里舒服
  • 自写 markdown 渲染器 —— 不想为了一个 <p> 引进来一整套依赖

第三条和第四条看起来矛盾,其实是我的划分标准:

简单样式用工具类拼,组件自身的排版用 SCSS 写,两边的边界是「这个样式会不会被别的地方复用」。

目录约定

变量、文件名统一用下划线命名,只有 Nuxt 自己规定的那几个目录保持原名:

page / layout / components  ->  保持默认,框架约定优先
composables                 ->  hooks
server/data                 ->  server/mock_data

改框架约定的目录名会让所有人对着文档发懵,不值得。

数据从哪来

后端还没写,先用 server/api 加本地假数据顶住,返回的格式和真实接口一致:

interface Api_Result<T> {
    code: number
    message: string
    data: T
}

以后接上真接口,只要把 baseURL 换掉,页面一行都不用动。

还没做完的

  • 图片仍然是原图直出,没有做响应式尺寸
  • 代码块没有语法高亮,暂时是纯色块
  • 深色模式留了变量,但这版不上

先上线,再迭代。