这个博客是从零开始搭的。这篇文章把整个过程记下来，一来以后自己回头看有个参照，二来如果有人也想搭一个，可以少走一点弯路。
为什么想自己搭一个
起因很普通：想有个地方放自己的东西。
写过的笔记散在各种 App 里，聊天记录里也有，过一阵就找不到了。我想要的是一个自己能完全掌控、又几乎不用维护的地方——把文章写成纯文本文件存在本地，剩下的交给构建工具。
所以定下三条要求：
- 不写代码也能维护（我只会照着说明改配置文件）
- 没有数据库、没有后台、没有服务器要续费
- 打开要好看，毕竟是自己的地方
选型：为什么最后是 Astro + Mizuki
先试的思路是「现成的博客框架 + 现成的主题」，因为自己写前端不现实。比较下来大致是这样：
| 方案 | 二次元主题多不多 | 改配置难不难 | 结论 |
|---|---|---|---|
| Astro | 最多 | 低 | ✅ 选了它 |
| Hexo | 多，但风格偏旧 | 低 | 生态在退潮 |
| Hugo | 很少 | 高（要改模板） | 放弃 |
| Next.js | 少，基本要自建 | 高 | 放弃 |
关键其实不是 Astro 本身，而是好看的二次元风格主题几乎只在 Astro 生态里。这一条直接决定了其他选项全部出局。
主题选的是 Mizuki，它基于 Fuwari 改的，带有 Material Design 3 的观感，评论、搜索、RSS 这些能力都接好了，需要改的东西集中在一个目录里。
实际动手的过程
整个搭建只有几条命令。先把主题仓库拉下来——这里用浅克隆，因为完整历史体积太大，国内网络经常传一半就断：
git clone --depth 1 --single-branch https://github.com/matsuzaka-yuki/Mizuki.git然后装依赖。注意 npm 官方源在这台电脑上连不上，要换成国内镜像：
# .npmrc 里写一行就够# registry=https://registry.npmmirror.com/pnpm install装完之后：
pnpm dev # 本地预览，改文件会自动刷新pnpm build # 生成最终要发布的静态文件pnpm dev 起来之后打开 http://localhost:3000/，看到完整的页面，这一步就成了。
改配置：其实只动一个目录
站点身份信息全在 src/config/ 里，不用碰页面代码。比如站点名称和副标题：
export const siteConfig: SiteConfig = { title: "我的博客", subtitle: "记录学习与生活的点滴", siteURL: "https://www.xfengling.me/", // 换成自己的域名 siteStartDate: "2026-10-17", timeZone: "Asia/Shanghai",};写文章的归类规则也很简单，只有两个分类，标签交叉索引：
---title: 文章标题published: 2026-10-18description: 一句话摘要，会显示在卡片上tags: [Astro, 建站]category: 技术draft: false---踩到的几个坑
坑一：全局 git 配置里有失效的代理规则
所有从 GitHub 拉代码的操作都会失败，而且报错信息完全看不出原因。最后发现是 .gitconfig 里有一条指向已经停止服务的代理的重写规则，删掉就好。
改全局配置前先备份
git config --global的改动会影响这台机器上所有仓库。删之前先复制一份.gitconfig出来。
坑二：依赖下载慢到以为卡死
第一次装依赖花了五分钟。把 npm 源换成国内镜像之后降到两分钟左右。第二次再装因为本地有缓存，就快很多了。
坑三：构建最后一步的搜索索引失败
pnpm build 会在最后生成站内搜索索引，需要联网下载一个二进制文件，这一步在本机失败了。
Failed to install either of [pagefind_extended, pagefind].Most likely the platform windows-x64 is not yet a supported architecture.页面本身是全部构建成功的，只是搜索用不了。搜索属于后面单独处理的事，先放着。
现在的写作流程
这是我最在意的部分——如果写一篇文章要折腾十分钟，我肯定坚持不下来。现在的流程是：
- 在
src/content/posts/下新建一个.md文件 - 打开编辑器，在文件开头填标题、日期、分类、标签
- 正文用 Markdown 写
- 保存，浏览器里立刻能看到效果
- 满意了
git push，托管平台自动构建发布
接下来想做的事
- 把首页头图和头像换成自己的图
- 填一下项目、技能、时间线三个页面
- 域名的事情等上线实测之后再说
博客搭好只是开始，真正的部分是把东西写出来。这一篇算第一块砖。
如果这篇文章对你有帮助，欢迎分享给更多人！
部分信息可能已经过时