用Firefly博客主题搭建个人博客

为什么选择 Firefly#

Firefly 是一款基于 Astro 的现代极简博客主题。先区分两个概念：

• 框架：技术底层，本博客用的是 Astro（配合 Svelte 做交互组件）。
• 主题：皮肤美化，本文用的就是 Firefly 主题，它 fork 自 Fuwari，做了大量功能增强。

第一步：准备环境#

需要：

• Node.js ≥ 22
• pnpm（本项目强制）
• Git

1
node -v
2
pnpm -v
3
git --version

第二步：拉取主题源码#

在 GitHub 上 fork CuteLeaf/Firefly 到自己账号，再克隆到本地：

1
git clone https://github.com/<你的用户名>/Firefly.git
2
cd Firefly

第三步：安装依赖#

1
pnpm install

第四步：本地预览#

1
pnpm dev

浏览器打开 http://localhost:4321，就能看到博客首页。

第五步：配置站点#

站点信息都在 src/config/ 下，最核心的是 siteConfig.ts（站点名称、简介、时区等）和 profileConfig.ts（个人资料）。改配置即可，无需动组件源码。

新建文章与动态：

1
pnpm new-post 我的第一篇文章
2
pnpm new-d 今天的心情

第六步：部署到 Cloudflare Pages#

1. 在 Cloudflare 控制台新建 Pages 项目，连接你的 GitHub 仓库。
2. 生产分支选 main。
3. 构建命令 pnpm build，输出目录 dist。
4. 保存后，推送即自动构建上线。

1
git add .
2
git commit -m "feat: 初始化博客"
3
git push origin main

之后每次推送都会自动部署，静态托管免费档基本无账单风险。

小结#

至此，一个基于 Firefly 主题的个人博客就跑起来了。祝写作愉快！