Firefly 更新方式

方法一：Git 合并（推荐）#

如果你是通过 git clone 获取的项目，可以通过 Git 拉取上游更新。

1
git remote add upstream https://github.com/CuteLeaf/Firefly.git

1
git fetch upstream

1
git merge upstream/master

1
git add .
2
git commit -m "merge: update Firefly theme"

方法二：手动覆盖#

如果 Git 合并冲突太多或者你做了大量自定义修改：

1. 备份你的配置文件和内容：

• src/config/ — 所有配置文件
• src/content/ — 文章和页面内容
• public/ — 静态资源（图片、字体等）

2. 下载最新版本的 Firefly

3. 将备份的文件还原到对应目录

4. 重新安装依赖：

1
pnpm install

5. 启动开发服务器，检查是否有报错：

1
pnpm dev

更新后检查#

更新完成后，建议检查以下内容：

1. 配置文件兼容性：新版本可能新增了配置项，查看仓库的 commit 记录了解变更
2. 类型检查：如果 TypeScript 报错，说明配置文件的类型定义可能有变化，参照类型定义补充新增的必填字段
3. 依赖更新：运行 pnpm install 确保依赖是最新的
4. 本地预览：运行 pnpm dev 在本地预览，确认页面渲染正常
5. 构建测试：运行 pnpm build 确认构建没有错误