以下是 在 Windows 10 系统上搭建 Hexo 个人博客 的环境准备指南，按照工具分类整理了安装步骤和关键命令：

一、基础工具安装

1. Git

  • 作用：用于版本控制和与 GitHub 交互。

  • 安装步骤：

    1. 下载 Git 安装包：

      1
      https://git-scm.com/download/win

      image-20250430103112752

    2. 双击安装包，按照默认选项安装（勾选 Add Git to PATH）。

    3. 验证安装：

      1
      git --version

    4. 效果展示：

      image-20250430102852382

2. Node.js 和 npm

  • 作用：Hexo 是基于 Node.js 的静态博客框架，npm 是其包管理工具。
  • 安装步骤：
    1. 下载 LTS 版本（推荐）：
      1
      https://nodejs.org/zh-cn/download/
    2. 双击安装包，选择自定义安装路径（例如 D:\Program Files\nodejs），并勾选添加到系统环境变量。
    3. 验证安装：
      1
      2
      node -v   # 查看 Node.js 版本
      npm -v    # 查看 npm 版本
    4. （可选）切换为国内镜像加速安装：
      1
      npm config set registry https://registry.npmmirror.com

3. Hexo CLI

  • 作用：Hexo 命令行工具，用于初始化博客项目和生成静态文件。
  • 安装步骤：
    1. 全局安装 Hexo：
      1
      npm install -g hexo-cli
    2. 验证安装：
      1
      hexo -v

二、Hexo 博客初始化

1. 创建博客目录

1
2
3
4
5
6
# 在 D 盘创建 blog 文件夹（可根据需求修改路径）
mkdir D:\blog
cd D:\blog

# 初始化 Hexo 博客项目
hexo init

初始化时会从 GitHub 拉取 hexo-starter 仓库模板。

2. 安装依赖

1
npm install

根据 package.json 安装项目所需依赖。

3. 启动本地服务器

1
hexo server

默认访问地址：http://localhost:4000

三、连接githup

一、生成并添加 SSH 密钥

1. 生成 SSH 密钥

bash深色版本

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

2. 将公钥添加到 GitHub

  1. 复制公钥内容：

    bash深色版本

    1
    2
    cat ~/.ssh/id_ed25519.pub
    Windows是用记事本打开复制粘贴即可

  2. 登录 GitHub → Settings → SSH and GPG keys → 点击 New SSH key：

    • Title：自定义名称（如 Windows Hexo Blog）
    • Key：粘贴上一步复制的内容
    • 点击 Add SSH key

    image-20250430105024657

二、配置 Hexo 使用 SSH 部署

1. 修改 _config.yml 文件

打开 Hexo 博客目录下的 _config.yml 文件（例如 D:\blog\_config.yml），找到 deploy 配置段，修改为：

yaml深色版本

1
2
3
4
deploy:
  type: git
  repo: git@github.com:<你的GitHub用户名>/<你的GitHub用户名>.github.io.git
  branch: main

替换 <你的GitHub用户名> 为实际用户名。
示例：若 GitHub 用户名为 john，则填写：

yaml深色版本

1
repo: git@github.com:john/john.github.io.git

三、验证 SSH 连接

bash深色版本

1
ssh -T git@github.com

成功时会显示：

深色版本

1
Hi <你的GitHub用户名>! You've successfully authenticated...

image-20250430105215880

四、部署 Hexo 博客

  1. 执行以下命令：

    bash深色版本

    1
    hexo clean && hexo generate && hexo deploy

  2. 如果一切正常，不会提示输入用户名/密码，直接完成部署。

这里查看写的帮助文档https://gdhgxd.cn/2025/04/26/githubhelp/用于通过githup部署个人博客。