迁移博客

Hexo博客迁移到新电脑教程

一、需要备份的文件

在旧电脑上，以下文件/文件夹是迁移必需的：

文件/文件夹 说明
package.json 依赖包名称和版本号
scaffolds/ 文章模板文件夹
source/ 所有博客文章、页面
themes/ 主题文件夹
_config.yml 站点配置文件
.gitignore Git忽略配置

推荐备份方式：将博客源码推送到GitHub私有仓库，这样新电脑直接clone即可。

二、新电脑环境准备

1. 安装基础环境

1
2
3
4
5
6
7
8
9
10
# 安装 Node.js（推荐 v16 或 v18 LTS）
# 访问 https://nodejs.org 下载安装

# 安装 Git
# 访问 https://git-scm.com 下载

# 验证安装
node -v
npm -v
git --version

2. 安装 Hexo

1
2
3
4
npm install -g hexo-cli
# 或使用 pnpm
npm install -g pnpm
pnpm install -g hexo-cli

三、恢复博客

方法A：从GitHub克隆（推荐）

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 克隆博客源码仓库
git clone https://github.com/你的用户名/你的博客仓库.git

# 进入目录
cd 你的博客目录

# 安装依赖
npm install
# 或 pnpm install

# 清理缓存并生成
hexo clean
hexo g

# 本地预览
hexo server

方法B：手动复制文件

1
2
3
4
5
6
7
8
9
10
11
12
13
# 1. 在新电脑创建博客目录
hexo init blog
cd blog

# 2. 复制旧电脑备份的文件覆盖：
# - scaffolds/、source/、themes/、_config.yml、package.json

# 3. 安装依赖
npm install

# 4. 清理缓存并预览
hexo clean
hexo server

四、注意事项

  1. 主题配置：如果主题有额外依赖，需要在博客目录执行 npm install
  2. 部署密钥：如使用GitHub部署，需重新配置SSH密钥
  3. 图片路径：确保 source/images 或图床配置正确
  4. node_modules：不建议通过Git传输，建议在新电脑重新 npm install

五、推荐：建立Git工作流

为方便后续迁移，建议：

  1. 创建两个分支：main（发布）和 source（源码）
  2. 在 .gitignore 中添加：
    1
    2
    3
    node_modules/
    public/
    .deploy_git/
  3. 每次写完博客后 git push 源码到仓库

这样在任何电脑只需 git clone 即可继续创作。

折腾
折腾

本博客所有文章除特别声明外，均采用 CC BY-SA 4.0 协议 ，转载请注明出处！