WordPress 博客迁移到 Hexo 详细教程（内容优先版）#

1. 安装基础运行环境#

迁移和运行 Hexo 需依赖 Node.js 和 Git，二者为必装工具：

• Node.js：Hexo 基于 Node.js 开发，提供核心运行环境。
  下载地址：Node.js 官网（建议选择 LTS 长期支持版，安装时勾选“Add to PATH”便于后续命令行调用）。
  验证安装：打开终端（Windows 用 cmd/PowerShell，macOS/Linux 用 Terminal），执行 node -v 和 npm -v，若显示版本号则安装成功。
• Git：用于版本控制和部署 Hexo 博客到代码仓库（如 GitHub）。
  下载地址：Git 官网（Windows 安装时建议选择“Use Git from Git Bash only”以外的选项，确保终端可调用 Git 命令）。
  验证安装：终端执行 git --version，显示版本号即成功。

2. 配置 GitHub 仓库（可选，用于部署）#

若计划将 Hexo 博客部署到 GitHub Pages（免费托管），需提前创建仓库：

1. 登录 GitHub，点击右上角“+”→“New repository”。
2. 仓库名称必须为 用户名.github.io（“用户名”需替换为你的 GitHub 账号名，区分大小写），例如 zhangsan.github.io。
3. 勾选“Public”，点击“Create repository”完成创建。

3. 配置 SSH Key（可选，免密连接 GitHub）#

为避免每次部署时重复输入 GitHub 账号密码，建议配置 SSH Key：

1. 终端执行以下命令（替换为你的 GitHub 绑定邮箱），生成 SSH Key：

   1
   ssh-keygen -t ed25519 -C "your_email@example.com"
   

2. 按提示按回车键（无需设置密码），生成的 Key 文件默认存放在 ~/.ssh（Windows 为 C:\Users\用户名\.ssh）目录。
3. 打开 id_ed25519.pub 文件（用记事本或文本编辑器），复制全部内容。
4. 进入 GitHub 个人设置 →“SSH and GPG keys”→“New SSH key”，粘贴内容并命名（如“Hexo 部署”），点击“Add SSH key”。
5. 验证配置：终端执行 ssh -T git@github.com，出现 “Hi 用户名! You’ve successfully authenticated…” 即成功。

1. 导出 WordPress 原始内容#

1. 登录你的 WordPress 后台（通常地址为 你的域名/wp-admin）。
2. 进入“工具”→“导出”，选择“所有内容”（或按需选择“文章”“页面”），点击“下载导出文件”，得到一个 .xml 格式的导出文件（如 wordpress-export-2024-05.xml）。
3. 将该 .xml 文件复制到 Hexo 工作目录根目录（方便后续调用，也可保留原路径）。

2. 用 npx 执行一次性迁移（无需安装插件）#

由于迁移仅需一次，推荐用 npx 临时调用迁移插件，避免残留冗余依赖：

1. 确保终端仍处于 Hexo 工作目录，执行以下命令（替换 <xml文件名> 为你的 WordPress 导出文件，如 wordpress-export-2024-05.xml）：

   1
   npx hexo-migrator-wordpress <xml文件名>
   2
   # 示例（若文件在 Hexo 根目录）
   3
   npx hexo-migrator-wordpress wordpress-export-2024-05.xml
   4
   # 若文件在其他路径，需写绝对路径，例如 Windows：
   5
   npx hexo-migrator-wordpress "C:\Downloads\wordpress-export-2024-05.xml"
   

2. 等待迁移完成，终端会提示“Migration completed”。
3. 验证迁移结果：打开 Hexo 工作目录下的 source/_posts 文件夹，迁移后的文章会以 .md（Markdown）格式存在，包含原文章的标题、内容、发布时间、标签、分类等信息。

1. 配置 Hexo 部署参数#

1. 打开 Hexo 工作目录下的 _config.yml 文件（核心配置文件，用记事本或 VS Code 编辑），拉到最后找到 deploy 部分，修改为：

   1
   deploy:
   2
     type: git
   3
     repository: git@github.com:你的GitHub用户名/你的GitHub用户名.github.io.git
   4
     branch: main  # 注意：GitHub 仓库默认分支可能是 main 或 master，需与仓库一致
   

   示例（假设用户名为 zhangsan）：

   1
   deploy:
   2
     type: git
   3
     repository: git@github.com:zhangsan/zhangsan.github.io.git
   4
     branch: main
   

2. 安装部署依赖并推送#

1. 终端执行命令安装 Hexo Git 部署插件：

   1
   npm install hexo-deployer-git --save
   

2. 生成最新静态文件并部署到 GitHub：

   1
   # 清除旧的静态文件（可选，避免缓存问题）
   2
   hexo clean
   3
   # 重新生成静态文件
   4
   hexo g
   5
   # 部署到 GitHub
   6
   hexo deploy  # 可简写为 hexo d
   

3. 部署完成后，等待 1-5 分钟（GitHub 需同步文件），打开浏览器访问 https://你的GitHub用户名.github.io，即可看到迁移后的博客内容。