Skip to content

VitePress 博客搭建指南

本文将介绍如何从零开始搭建一个基于 VitePress 的个人博客。

环境准备

首先确保你的开发环境中已安装:

  • Node.js 18 或更高版本
  • pnpm(推荐的包管理器)
bash
# 安装 pnpm
npm install -g pnpm

项目初始化

使用 @sugarat/theme 提供的脚手架工具可以快速创建项目:

bash
pnpm create @sugarat/theme

或者手动创建项目并安装依赖:

bash
pnpm add vitepress @sugarat/theme vue

目录结构

├── docs
│   ├── .vitepress
│   │   ├── blog-theme.ts    # 主题配置
│   │   ├── config.mts       # VitePress 配置
│   │   └── theme
│   │       └── index.ts     # 主题入口
│   ├── posts                # 博客文章目录
│   │   └── *.md
│   ├── about.md             # 关于页面
│   └── index.md             # 首页
├── package.json
└── vercel.json              # Vercel 部署配置

写作技巧

Frontmatter 配置

每篇文章都可以通过 frontmatter 设置元数据:

yaml
---
title: 文章标题
date: 2026-03-20
description: 文章描述
tags:
  - 标签1
  - 标签2
---

代码高亮

VitePress 内置了代码高亮支持,使用三个反引号加语言标识即可:

js
console.log('Hello VitePress!')

总结

VitePress + @sugarat/theme 的组合让博客搭建变得非常简单,专注于内容创作即可。

上次更新于: