本文整理了 Hexo + Git 搭建个人博客并部署到 GitHub Pages 的详细流程，结合实际踩坑经验，适合新手快速上手，也方便自己日后查阅。

📖 前言

主要参考：如何用Hexo搭建个人博客?。
原文部分内容有误或不够详细，本文进行了补充和修正。

🛠️ 本地 Blog 同步 GitHub

  1. 进入本地用于放博客的文件夹。
  2. 右键空白处选择 Git Bash Here（如果未安装 Git Bash，请先安装 Git）。

🚀 Hexo 安装与项目依赖

初始化 Hexo 项目：

1
hexo init

进入项目目录后安装依赖：

1
npm install

该命令会根据 package.json 安装所有依赖项。

Hexo 默认不带部署功能，需安装部署插件：

1
npm install hexo-deployer-git --save
  • hexo-deployer-git：官方推荐的 Git 部署插件，支持一键部署到 GitHub、Gitee 等平台。

🏃 常用命令速查

1
2
hexo g   # 生成静态页面
hexo s   # 启动本地服务器，默认端口4000

访问 http://localhost:4000 查看效果。

☁️ 配置 GitHub Pages 部署

编辑博客根目录下的 _config.yml，添加或修改如下配置：

1
2
3
4
deploy:
  type: 'git'
  repository: https://github.com/你的用户名/你的仓库名.git
  branch: 'main' # 推荐加单引号，避免分支名识别问题

deploy 配置决定 Hexo 的 hexo d 命令将静态网页推送到哪个仓库和分支。

🔑 Git 基本配置（首次使用需设置）

1
2
git config --global user.email "你的邮箱"
git config --global user.name "你的名字"

🚩 一键部署上线

1
2
hexo deploy
# 或简写为 hexo d

生成的静态网页会自动推送到你配置的 GitHub 仓库。

⚙️ 博客基础参数配置

在 _config.yml 中可设置博客基本信息：

1
2
3
4
5
6
7
title: 博客标题
subtitle: 副标题
description: 描述
keywords: 关键词
author: 站主
language: zh-CN
timezone: Asia/Shanghai

新建文章：

1
hexo new [文章标题]

新文章会生成在 source/_posts 目录下。

🧐 常见问题解答

  1. main 分支里没有看到文件？
    • 可能上传到了 master 分支，检查 branch 配置和分支名。
  2. 如何重命名分支？
    • 使用 git branch -m 新分支名 重命名当前分支。

🔗 相关链接与推荐