Skip to content

独立博客搭建指南:为什么我选择了 VitePress

发布时间:2023-06-18 08:00
最后编辑:2023-06-18 08:00
全文大约 0 字(读完需 1 分钟)

想搭个人博客想了很久,终于在这个月动手了。

折腾了一圈,最终选择了 VitePress。来分享一下选型过程。

需求梳理

我的需求很简单:

  1. 写 Markdown:本地写文章,不想用后台编辑器
  2. 部署简单:推代码就能发布
  3. 加载快:静态站点优先
  4. 能折腾:想自定义样式和功能

基于这些需求,排除了 WordPress(太重)和 Notion(不够自由)。

对比过程

Hexo

用过一段时间,优点是主题丰富。

缺点是 Node.js 版本升级后经常出问题,而且配置文件的 YAML 格式容易出错。

Hugo

构建速度飞快,单个博客几十毫秒就能编译。

但 Go 模板语法太难写了,自定义主题的学习成本很高。

VitePress

Vue 技术栈,模板语法熟悉。热更新极快,开发体验舒服。

默认主题简洁,自定义也方便。

为什么选 VitePress

最核心的原因:我熟悉 Vue

VitePress 的自定义都是写 Vue 组件,等于用自己熟悉的技术栈搭博客。遇到问题能自己解决。

另外几个优点:

  • Vite 构建:热更新秒级
  • 内置功能:搜索、暗黑模式、代码高亮开箱即用
  • 部署简单:生成静态文件,扔 Vercel/Cloudflare Pages 就行

搭建过程

bash
npm create vitepress@latest
cd my-blog
npm install
npm run dev

不到五分钟就能看到本地预览。

剩下的时间都在折腾主题和样式,这才是大头。

总结

如果你也想搭博客,我的建议是:

  • 会 Vue:选 VitePress
  • 会 React:选 Docusaurus 或者 Next.js + MDX
  • 不想写代码:选 Notion + Super 或者 WordPress

工具不重要,重要的是动手开始写。

这个博客就是用 VitePress 搭的,你现在看到的就是效果。

Built with ❤️ using VitePress v2 & Vue & Vite