Wordpress迁移至Hexo教程

我的个人博客一开始是用 Wordpress 搭建的，其实当初选择 Wordpress 也是经过了比较久的调研，不过后来发现 Wordpress 并不适合我，所以就花了一点时间迁移到了 Hexo，迁移过程积累了一些经验，也遇到了一些坑，这里记录一下：

迁移步骤

安装 Hexo

安装 Hexo 很简单，只需要：

1 2	npm install -g hexo-cli hexo init <blog_dir>

注：如果安装速度比较慢，可以尝试淘宝镜像，具体请自行搜索

导出 Wordpress 文章

这一步也很简单，直接访问 Wordpress 的后台-工具-导出，导出的 .xml 文件包括文章、页面、评论、自定义栏目、分类和标签等数据

导入文章至 Hexo

这一步其实也很简单。。首先，安装迁移的插件：

1 2	cd <blog_dir> npm i hexo-migrator-wordpress --save

插件安装完成后，执行下列命令来迁移所有文章。source 可以是 WordPress 导出的文件路径或网址。

1	hexo migrate wordpress <source>

这个插件只能做到一些基础的迁移，迁移之后还需要再进行一些修正：

需要进行的修改

代码块

迁移之后的 Markdown 文件中的代码块是不会自动加上 ``` 的，所以需要手动修正；其实也可以通过脚本进行修正，但是很难判断代码块所属语言类型，同时还需要二次确认，这样的话反而还不如逐篇文章进行修正。

除此之外，迁移之后的代码块中可能会出现很多错误的转义符，多表现为：

_ 变成了 \_
< 变成了 \<
> 变成了 \>
[ 变成了 \[
] 变成了 \]

其实还会有其他情况，就不一一列举了，所以在迁移之后我们需要手动进行修复，最好不要直接暴力地全局替换，因为有时候转义符还是需要的，我们只需要替换代码块中出现的即可。

categories 字段

如果您有过使用 WordPress 的经验，就很容易误解 Hexo 的分类方式。WordPress 支持对一篇文章设置多个分类，而且这些分类可以是同级的，也可以是父子分类。但是 Hexo 不支持指定多个同级分类。下面的指定方法：

1
2
3

categories:
  - Diary
  - Life

会使分类Life成为Diary的子分类，而不是并列分类。因此，迁移之后需要对 categories 字段进行筛选，否则会出现分类过多的问题。

Hexo官方文档：分类方法的分歧

站内链接

wordpress 的 URL 命名规则和 Hexo 不一致，所以在迁移之后我们需要对 Markdown 中的站内网页链接进行修正替换；我也没想到什么好的方案，只能手动修正了。

表格

在用 wordpress 的时候，表格用了 TablePress 插件，迁移之后在 Markdown 中就无法展示了，不过 TablePress 提供了导出为 CSV 文件的功能，导出后我们可以借助一些在线工具（推荐一个：https://donatstudios.com/CsvToMarkdownTable）将其转换成 Markdown 格式的表格。

总有人间一两风，填我十万八千梦