Hexo 迁移到 Mizuki
约 733 字大约 2 分钟
2025-08-16
本指南将帮助您将 Hexo 博客文章迁移到 Mizuki 主题。
什么是 Mizuki？
Mizuki 是一个基于 Astro 开发的现代化博客主题，具有以下特点：
- 快速的静态站点生成
- 现代化的设计风格
- 优秀的 SEO 支持
- 响应式布局
- 支持多种内容格式
Hexo 与 Mizuki 文章格式差异
Hexo 格式示例：
title: "我的第一篇文章"
date: 2024-01-15 10:30:00
tags:
- Hexo
- 博客
categories:
- 随笔Mizuki 格式示例：
---
title: Markdown Tutorial
published: 2025-01-20
pinned: true
description: A simple example of a Markdown blog post.
tags: [Markdown, Blogging]
category: Examples
licenseName: "Unlicensed"
author: emn178
sourceLink: "https://github.com/emn178/markdown"
draft: false
---迁移步骤
1. 准备工作
- 备份您的 Hexo 博客文件
- 确保已安装 Mizuki 主题
- 准备文章存放目录：
src/content/posts/
2. 文章内容迁移
将 Hexo 的 source/_posts/ 目录下的所有 .md 文件复制到 Mizuki 的 src/content/posts/ 目录。
3. 手动调整 Frontmatter
转换完成后，您需要手动调整以下内容：
- 将
date字段改为pubDate，格式改为YYYY-MM-DD - 将
updated字段改为updatedDate，格式改为YYYY-MM-DD - 将
excerpt字段改为description - 将
categories数组的第一个元素作为category字符串 - 确保
tags为字符串数组格式
4. 静态资源迁移
图片和媒体文件
- 将 Hexo 的
source/images/目录复制到 Mizuki 的public/images/ - 图片路径通常保持不变：
- Hexo:
 - Mizuki:
- Hexo:
5. 更新内部链接
更新文章中的内部链接格式：
- Hexo:
[链接](/2023/01/01/post-name/) - Mizuki:
[链接](/posts/post-name/)
6. 验证迁移结果
迁移完成后，请检查以下项目：
常见问题
Q: 日期格式转换问题
A: 确保将 Hexo 的 YYYY-MM-DD HH:mm:ss 格式转换为 Mizuki 的 YYYY-MM-DD 格式。
Q: 图片无法显示
A: 检查图片路径是否正确，确保图片文件已复制到 public/images/ 目录。
Q: 标签和分类显示异常
A: 检查 frontmatter 中的 tags 是否为数组格式，category 是否为字符串格式。
高级功能迁移
评论系统
Mizuki 目前只支持 Twikoo 评论系统，可以在配置文件中启用。
SEO 优化
- 确保每篇文章都有
description字段 - 检查文章的 URL 结构是否符合 SEO 要求
- 验证 sitemap 和 RSS 订阅功能
RSS 订阅
Mizuki 会自动生成 RSS 订阅，无需额外配置。
总结
通过以上步骤，您可以成功将 Hexo 博客迁移到 Mizuki 主题。迁移过程中最重要的是确保 frontmatter 格式正确，以及静态资源路径的正确性。如果遇到问题，请仔细检查文件格式和路径配置。