Hexo 博客备份与恢复教程

教程 评论

为你的 Hexo 博客建立一个可靠的备份与恢复流程至关重要，这能确保你的心血之作在更换电脑或遇到意外时万无一失。目前，最专业、最推荐的方案是使用 Git 和代码托管平台（如 GitHub 或 Gitee）。

这个方法不仅能安全地备份你的博客“源码”，还能记录你每一次的修改历史，并且恢复起来极其简单。

核心原则：只备份“源码”，不备份“生成物”

在开始之前，请务必理解这个核心原则。

  • 需要备份的“源码”（博客的蓝图）：

    • source 文件夹：你所有的文章、草稿、图片等。
    • themes 文件夹：你的主题文件，尤其是你做过自定义修改的主题。
    • _config.yml 文件：整个站点的核心配置文件。
    • package.json 文件：记录了你安装了哪些 Hexo 插件，是恢复的关键。
    • scaffolds 文件夹：你的文章模板。
    • .gitignore 文件：告诉 Git 哪些文件不需要备份。

  • 不需要备份的“生成物”（可由蓝图重建）：

    • public 文件夹：由 hexo g 生成的网站静态文件。
    • node_modules 文件夹：所有插件的源文件，体积巨大。
    • db.json：Hexo 的数据库缓存文件。
    • .deploy_git 或 .deploy_oss：部署缓存文件夹。

首次使用的必要准备 (全局配置)

如果你是在这台电脑上第一次使用Git，需要先设置你的用户身份。这个操作对于一台电脑只需要做一次。

打开终端，运行以下两条命令，请将引号里的内容换成你自己的GitHub用户名和邮箱。

1
2
3
4
5
# 设置你的用户名
git config --global user.name "Your GitHub Username"

# 设置你的邮箱 (必须是你注册GitHub时使用的邮箱)
git config --global user.email "[email protected]"

第一部分：如何正确地备份你的 Hexo 博客

步骤 1: 创建一个 GitHub 仓库

  1. 登录你的 GitHub 账号。
  2. 点击右上角的 + 号，选择 New repository (新建仓库)。
  3. Repository name (仓库名称): 给仓库取个名字，例如 my-blog-backup。
  4. 关键一步: 选择 **Private (私有)**。这样只有你自己能看到和访问这个仓库，确保你的文章和配置安全。
  5. 点击 Create repository (创建仓库)。

步骤 2: 在本地博客中初始化 Git 并完成首次备份

  1. 创建 .gitignore 文件
    在你的 Hexo 博客根目录下，创建一个名为 .gitignore 的新文件，将以下内容完整地复制进去并保存：

    1
    2
    3
    4
    5
    6
    7
    .DS_Store
    Thumbs.db
    db.json
    *.log
    node_modules/
    public/
    .deploy*/

  2. 执行首次备份命令流
    在你的 Hexo 博客根目录下，打开终端，严格按顺序依次执行以下命令：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    # 1. 初始化本地 Git 仓库 (如果已初始化过，再运行也无妨)
    git init

    # 2. 将所有需要备份的文件添加到暂存区
    git add .

    # 3. 创建第一个提交记录 (这是让分支存在的关键)
    #    注意：-m 后面必须跟着用英文双引号括起来的说明文字
    git commit -m "首次备份我的Hexo博客"

    # 4. 将当前分支强制重命名为 main，以和 GitHub 新标准保持一致
    git branch -M main

    # 5. 关联到你在 GitHub 上创建的远程仓库 (请将 URL 换成你自己的)
    git remote add origin https://github.com/你的用户名/my-blog-backup.git

    # 如果上一步提示 "remote origin already exists"，说明已存在。
    # 请先运行 git remote remove origin 删除，再重新运行上面的 add 命令。

    # 6. 将本地的所有提交推送到 GitHub，完成第一次备份
    #    -u 参数只需要在第一次推送时使用
    git push -u origin main

步骤 3: 日常更新备份

以后，每当你写了新文章或对博客做了任何修改，只需要执行以下三条命令，即可将最新的改动备份到 GitHub：

1
2
3
4
5
6
7
8
# 1. 添加所有改动
git add .

# 2. 提交改动，并写下本次更新的内容
git commit -m "新增文章：xxxx"

# 3. 推送到 GitHub
git push

第二部分：如何在新电脑上恢复你的博客

步骤 1: 准备新环境

确保你的新电脑上已经安装了 Node.js 和 Git，并完成了本教程开头的全局配置 (git config)。

步骤 2: 克隆你的备份仓库

选择一个你想存放博客的文件夹，打开终端，运行 git clone 命令。

1
2
# 将 URL 换成你自己仓库的地址
git clone https://github.com/你的用户名/my-blog-backup.git

执行完毕后，你会得到一个 my-blog-backup 文件夹，里面包含了你所有的博客源码。

步骤 3: 恢复所有依赖（关键一步）

进入刚刚克隆下来的文件夹，然后运行 npm install。

1
2
3
4
5
# 进入你的博客文件夹
cd my-blog-backup

# 自动安装所有插件和依赖
npm install

npm 会自动读取 package.json 文件并下载所有必需的插件。

步骤 4: 验证恢复结果

现在，你的博客已经完美恢复了！运行本地预览命令来验证一下：

1
hexo s

打开浏览器访问 http://localhost:4000，所有内容都应该和原来一模一样。

总结

这个方法的逻辑就像是：

备份：只备份房子的“设计图纸”（源码），不备份“建好的房子”（生成物）。

恢复：在新地方拿到“设计图纸”，然后让施工队（npm install）按照图纸把一模一样的“房子”再建一遍。

李鑫记录学习的博客

主要用作个人学习中遇到的问题和成果记录