这个博客从最早的一份静态 HTML,到现在基于 Nuxt 4 与 Nuxt UI 的完整站点,中间迭代了三次。这篇文章记录一下最终的技术选型和落地细节,给同样想搭博客的朋友一个参考。
为什么选择 Nuxt 4
博客的核心诉求其实很简单:内容能被搜索引擎抓到、打开速度足够快、写文章不需要折腾。Nuxt 的 SSR 默认就能满足前两点,而文件路由和自动导入让新增页面几乎没有额外成本。
- SSR 渲染,首屏内容完整可抓取
- 基于 Vite,热更新速度快
- 与 Nuxt UI 深度集成,无需自己维护组件库
目录结构
页面、组件、布局各归各位,业务代码集中在 app/ 目录下:
app/
├─ components/ # 头部、页脚、文章卡片
├─ composables/ # 接口请求封装
├─ layouts/ # 默认布局
└─ pages/ # 首页、文章列表、文章详情
数据从哪里来
文章统一在后台管理系统中编写和发布,前台通过公开只读接口获取。这样写作体验和展示体验可以各自优化,互不干扰。
内容与展示分离,是这套方案里最重要的一个决定。
后续计划补充 RSS 输出和站内搜索,让这个博客更像一个长期维护的「笔记库」,而不是一次性的展示页。