把博客用 Nuxt 重写了一遍
旧版是 Vue3 + Vite 的单页应用,够用,但每次首屏都要等一包 JS 下载完才看得见字。这回换成 Nuxt 4,目标是首屏能直接读到内容。
为什么换
三个理由,按重要程度排:
- 首屏白屏太久了,尤其是手机上
- 想给搜索引擎和社交平台一个像样的分享卡片
- 顺手把多语言做掉,之前一直是硬编码中文
技术选型
- 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 换掉,页面一行都不用动。
还没做完的
- 图片仍然是原图直出,没有做响应式尺寸
- 代码块没有语法高亮,暂时是纯色块
- 深色模式留了变量,但这版不上
先上线,再迭代。