hexo+github免费搭建博客网站教程

一、Hexo 本地安装

1、安装 Node.js

• 在官网下载安装：Node.js 官方网站
• 安装时，请确保选中了“添加路径”选项。

2、安装 Git Bash

• 在官网下载安装：Git 官方网站

3、安装 Hexo

• 打开 Git Bash，设置 npm 镜像源（使用淘宝镜像）：

npm config set registry https://registry.npm.taobao.org

• 全局安装 Hexo CLI：

npm install -g hexo-cli

• 初始化博客（自定义博客名）

hexo init my-blog

• 进入博客目录并安装依赖：

cd my-blog
npm install

• 编译博客静态文件到 public 文件夹：

hexo g

• 启动本地预览：

hexo s

二、提交到 GitHub 仓库

注册 GitHub 账户

• 访问 GitHub 官方网站 注册账户。

创建 GitHub 仓库

• 创建一个新仓库，命名为 你的GitHub用户名.github.io，用于搭建 GitHub Pages 服务。

生成 SSH 密钥

• 在 Git Bash 中配置 GitHub 用户信息：bash复制代码
• git config --global user.name "你的GitHub用户名" git config --global user.email "你注册github的邮箱"
• 生成 SSH 密钥：bash复制代码

ssh-keygen -t rsa -C "你注册github的邮箱"

• 复制生成的公钥内容，粘贴到 GitHub 的 SSH 密钥设置页面：GitHub SSH 设置

配置 _config.yml 部署

• 在 _config.yml 中添加 GitHub 仓库信息：yml复制代码

deploy:
  type: git
  repo: https://github.com/你的GitHub用户名/你的GitHub用户名.github.io.git
  branch: main

安装 Hexo Git 部署插件

• 执行以下命令：bash复制代码

npm install hexo-deployer-git --save

部署到 GitHub

• 清理缓存并生成新的静态文件：bash复制代码

hexo clean && hexo g && hexo de

• 访问 https://你的GitHub用户名.github.io 查看效果。

三、安装 Butterfly 主题

使用 Git 克隆 Butterfly 主题到 Hexo 项目的 themes 目录：bash复制代码

1、安装 Butterfly 主题

使用 Git 克隆 Butterfly 主题到 Hexo 项目的 themes 目录：

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

2、安装渲染器

npm install hexo-renderer-pug hexo-renderer-stylus --save

3、修改 _config.yml 配置

theme: butterfly

4、更新并部署

hexo clean && hexo g && hexo de