前言
嗨嗨 (｡･ω･｡)ﾉ♡ 这里是 Aria-7！
一直想要一个属于自己的小窝，能写写东西记录学习过程中的各种破事。纠结了好几种方案之后，最后选了基于 Astro 的 Firefly 主题来搭博客。这篇文章就记一下搭建过程，还有那些踩到的坑… 只能说真的不少 (´;ω;`)
希望能帮到同样在折腾博客的你 ヽ(✿ﾟ▽ﾟ)ノ
为什么选 Firefly
其实也没啥特别高大上的理由啦 (´▽`ʃ♡ƪ)
- 不用管服务器 —— 纯静态站，部署完就不用操心了
- 好看 —— 界面戳我，开箱就能用
- 改起来方便 —— 配置改改就行，不用动源码
- 写文章舒服 —— Markdown 一把梭
Firefly 是基于 Astro 做的博客主题，该有的功能基本都有：深色模式、评论、音乐播放器、标签分类什么的。对我来说够用了 (◍•ᴗ•◍)✧
搭建流程（简略版）
1. 拉代码装依赖
git clone 仓库地址
pnpm install
pnpm dev装依赖的时候如果卡住可以换镜像源试试看 (｀・ω・´)
2. 改配置文件
所有核心配置都在 src/config/ 这个文件夹里：
| 文件 | 干啥的 |
|---|---|
siteConfig.ts | 站点标题、描述、域名之类的 |
profileConfig.ts | 头像、昵称、个人简介 |
sponsorConfig.ts | 赞助方式和收款码 |
commentConfig.ts | 评论系统 |
navBarConfig.ts | 导航栏链接 |
改完这些基本就完成个性化设置了，还是挺方便的 (´▽`ʃ♡ƪ)
3. 清理示例
模板自带了示例文章，删掉 src/content/posts/ 下面的文件就行。
4. 部署
选了 Vercel 部署。代码推到 GitHub，Vercel 自动就识别出是 Astro 项目开始构建了，省心 (ง •̀_•́)ง
踩的那些坑
坑一：GitHub 不给我算贡献
在 Fork 的仓库里改了东西，结果主页绿点图什么都没有…
原因：GitHub 的贡献统计对 Fork 仓库的提交计算很迷，不会立刻显示。
解决：
- 直接建个全新的仓库，别从原项目 Fork
- 用
git checkout --orphan清掉旧的提交历史 - 强制推送到新仓库
git checkout --orphan latest
git add -A
git commit -m "初始化博客"
git push origin master --force坑二：Contributors 列表阴魂不散
Git 历史都重置了，GitHub 仓库还显示原模板的 20 个人…
原因：GitHub 的贡献者统计有缓存 (╯°□°）╯︵┻━┻
解决：
- 等 24-48 小时，GitHub 自己会刷新
- 或者再推一个新提交触发重新统计
- 最彻底的办法还是建一个全新的仓库从头推
坑三：中文域名搞不定… 我放弃了
买了个
飞行雪绒.top想装一下，结果折腾了半天 Vercel 一直解析不了 (´；ω；｀)
试了 Punycode 编码、配了 DNS 记录、等了好几个小时… 还是不行。
最后放弃了，直接用的 Vercel 默认域名（aria7-blog.vercel.app）。反正也能用，以后再研究吧 (´-﹏-`；)
坑四：赞助页面有两条示例数据
赞助者列表里默认有两条示例数据（夏叶 ¥50、匿名用户 ¥20）。
解决：在 sponsorConfig.ts 里注释掉，保留着格式模板方便以后再加（这个思路我觉得挺好的，推荐 (◍•ᴗ•◍)）
坑五：Giscus 评论系统配置有点繁琐
步骤：
- 在 GitHub 仓库设置里开启 Discussions
- 安装 giscus GitHub App
- 去
commentConfig.ts里填配置
type: "giscus",
giscus: {
repo: "你的用户名/你的仓库名",
repoId: "R_kgDO...",
category: "Announcements",
categoryId: "DIC_kwD...",
mapping: "pathname",
}repoId 和 categoryId 可以从 giscus 的 API 获取。配好了还挺好用的，访客用 GitHub 登录就能评论 (´▽`ʃ♡ƪ)
坑六：关掉功能后导航栏还有残留
关了友链、番组、相册，结果导航栏还在那里…
解决：去 siteConfig.ts 里把对应的开关设为 false 就行了，导航栏会自动隐藏。是我自己没配置到位 (｡ŏ﹏ŏ)
一些碎碎念
先本地改好了再推送
pnpm dev 可以实时预览，建议全部改满意了再推到线上 (`･ω･´)b
配置文件注释很贴心
Firefly 的每个配置文件都有详细的注释说明（中文的哦），改之前看一眼不至于懵。
示例数据留着当模板
不要直接删，注释掉就好。以后要用的时候取消注释改一改就行，省得忘了格式 (๑•̀ㅂ•́)و✧
仓库名字想好再起
仓库名会直接影响 Vercel 生成的子域名（比如 xxx.vercel.app），提前规划好省得后面改。
结语
折腾了一通，博客总算是有个样子了 (´▽`ʃ♡ƪ) Firefly 主题确实挺完善的，大部分想要的功能改改配置就有了，不用动源码这点好评。
希望这篇东西能帮到也在搭博客的你！有什么问题欢迎在下面评论区唠嗑 (｡･ω･｡)ﾉ♡