用 VitePress 搭建个人博客的完整记录

这篇博客本身就是 VitePress 搭建的，这里记录一下整体的搭建过程与心得。

为什么选 VitePress

• 基于 Markdown 写作，专注内容
• 内置本地全文搜索、多语言支持
• 构建速度快，产物是纯静态页面，部署简单

基本结构

docs/                # 站点源码
├─ .vitepress/       # 配置与主题
├─ index.md          # 首页
└─ posts/            # 博客文章

踩坑记录

1. Node 版本：官方文档建议 Node 22+，v1.6 在 Node 20 上运行正常。
2. 多语言：通过 locales 配置，页面文件按语言目录组织。
3. 本地图标：把 Lucide 图标下载到本地 icons/ 目录，用 vite.publicDir 暴露为静态资源，避免外链。

欢迎继续关注后续文章。