技术笔记置顶

用 Nuxt 4 + Nuxt UI 搭建个人博客的完整实践

南客笔记 2026/11/12 1,308 次浏览

这个博客从最早的一份静态 HTML,到现在基于 Nuxt 4 与 Nuxt UI 的完整站点,中间迭代了三次。这篇文章记录一下最终的技术选型和落地细节,给同样想搭博客的朋友一个参考。

为什么选择 Nuxt 4

博客的核心诉求其实很简单:内容能被搜索引擎抓到、打开速度足够快、写文章不需要折腾。Nuxt 的 SSR 默认就能满足前两点,而文件路由和自动导入让新增页面几乎没有额外成本。

  • SSR 渲染,首屏内容完整可抓取
  • 基于 Vite,热更新速度快
  • 与 Nuxt UI 深度集成,无需自己维护组件库

目录结构

页面、组件、布局各归各位,业务代码集中在 app/ 目录下:

app/
├─ components/   # 头部、页脚、文章卡片
├─ composables/  # 接口请求封装
├─ layouts/      # 默认布局
└─ pages/        # 首页、文章列表、文章详情

数据从哪里来

文章统一在后台管理系统中编写和发布,前台通过公开只读接口获取。这样写作体验和展示体验可以各自优化,互不干扰。

内容与展示分离,是这套方案里最重要的一个决定。

后续计划补充 RSS 输出和站内搜索,让这个博客更像一个长期维护的「笔记库」,而不是一次性的展示页。

相关文章

深入理解 日志系统设计

这是「日志系统设计」主题下的一篇实践记录:深入理解 日志系统设计。内容用于填充示例数据,方便浏览分页、搜索结果与文章详情。 为什么关注这个主题 在真实项目里,日志系统设计往往不是孤立的知识点,而是和性能、稳定性、可维护性纠缠在一起。把它单独拿出来梳理一遍,遇到问题时才有判断依据。 实践要点 先明确目标与边界,再挑选方案…

南客笔记 2026/10/30 604

深入理解 Git 分支工作流

这是「Git 分支工作流」主题下的一篇实践记录:深入理解 Git 分支工作流。内容用于填充示例数据,方便浏览分页、搜索结果与文章详情。 为什么关注这个主题 在真实项目里,Git 分支工作流往往不是孤立的知识点,而是和性能、稳定性、可维护性纠缠在一起。把它单独拿出来梳理一遍,遇到问题时才有判断依据。 实践要点 先明确目标…

南客笔记 2026/10/29 742

深入理解 单元测试实践

这是「单元测试实践」主题下的一篇实践记录:深入理解 单元测试实践。内容用于填充示例数据,方便浏览分页、搜索结果与文章详情。 为什么关注这个主题 在真实项目里,单元测试实践往往不是孤立的知识点,而是和性能、稳定性、可维护性纠缠在一起。把它单独拿出来梳理一遍,遇到问题时才有判断依据。 实践要点 先明确目标与边界,再挑选方案…

南客笔记 2026/10/28 877