学习建立 Blog，Hexo + GitHub Pages

最新推荐文章于 2025-09-11 14:37:56 发布

原创最新推荐文章于 2025-09-11 14:37:56 发布 · 406 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Blog

Blog 专栏收录该内容

1 篇文章

订阅专栏

本文介绍如何使用Hexo结合GitHub Pages快速搭建个人博客，包括安装配置Node.js、Git、Hexo，以及如何部署到GitHub并设置自定义域名。

正在学，小白通过学习建立 Blog 可以学到很多知识，希望今天能学好相关知识，建成自己的
Blog 吧。

教程来自以下 Blog：基于 Hexo + GitHub Pages 免费搭建个人博客最强教程

以下内容根据上面这篇博客精简修改。

安装 Node.js :

下载地址: https://nodejs.org/en/download/
Windows下安装非常简单。其他系统参考：Node.js 安装配置

安装 Git：

下载 Git : https://git-scm.com/download/
安装 Git : 和 Node.js 相似，Windows下一直下一步。
Git 入门教程 : Pro Git（中文版）来自码云

安装Hexo :

a. 打开Git Bash
b. 输入命令：

npm install -g hexo-cli

c. 初始化hexo，选择目录：

hexo init e:\blog

d. 进入目录：

cd e:\blog

e. 执行命令，安装依赖包

npm install

f. 生成部署文件，启动本地服务

hexo generate
hexo server

Hexo 几个常用的命令：

hexo generate (hexo g) 生成静态文件，会在当前目录下生成一个新的叫做public的文件夹
hexo server (hexo s) 启动本地web服务，用于博客的预览
hexo deploy (hexo d) 部署博客到远端服务器
hexo new "postName" #新建文章
hexo new page "pageName" #新建页面

此时打开 http://localhost:4000/ 可以看到搭建的本地博客

使用 GitHub Pages :

注册 GitHub 账号
创建项目仓库，访问 https://github.com/new 创建仓库
注意仓库名称必须是 username/username.github.io
配置 SSH :
a. 检查本地是否存在 ssh key，在Git Bash输入指令：

ls -al ~/.ssh

如果存在删除 .ssh 文件夹下所有文件

b. 设置 name 和 email

git config --global user.name "<your name>"
git config --global user.email "<your email>"

name 和 email 与 GitHub 无关

生成 ssh 密钥

ssh-keygen -t rsa -C "your GitHub email"

一路回车，可设置密码
此步骤在 ~/.ssh/ 下生成 id_rsa 和 id_rsa.pub 文件

获取 Key

$ cat ~/.ssh/id_rsa.pub

在 GitHub 上添加 SSH 密钥

在https://github.com/settings/keys下 add new ssh key

Personal settings –> SSH and GPG keys –> SSH keys –> New SSH key

设置后输入命令：

ssh git@github.com

若成功，返回以下大致内容

The authenticity of host 'github.com (192.30.252.128)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'github.com,192.30.252.128' (RSA) to the list of known hosts.
Hi git-xuhao! You've successfully authenticated, but GitHub does not provide shell access.
Connection to github.com closed.

部署到 GitHub

a. 配置 _config.yml

# Deployment
## Docs: https://hexo.io/docs/deployment.html
# ssh://git@github.com/git-xuhao/git-xuhao.github.io
deploy:
type: git
repo: ssh://git@github.com/thebitmin/thebitmin.github.io
branch: master

repo 换成自己的 GitHub 仓库，因配置了 SSH-Key 必须填写 SSH 形式的 URL。
每个 : 后面必须有一个空格。

b. 安装 Git 包

npm install hexo-deployer-git --save

c. 部署到 GitHub 上

hexo deploy

现在可以通过 https://thebitmin.github.io 访问此博客。

Hexo配置文件

Hexo 中两个常用的配置文件：
a. 博客的配置文件：

E:\blog\_config.yml

配置文件说明大致如下：

# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title: blog name    #博客名
subtitle: Goals determine what you are going to be    #副标题
description: Goals determine what you are going to be #用于搜索，没有直观表现
author: huangjunhui    #作者
language: zh-CN    #语言
timezone:     #时区，若不填写，以你目前电脑的时区为默认值

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://yoursite.com
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:

# Directory
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:

# Writing    文章布局等
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight:
  enable: true
  line_number: true
  tab_replace:

# Category & Tag
default_category: uncategorized
category_map:
tag_map:

# Date / Time format    时间格式
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-MM-DD
time_format: HH:mm:ss

# Pagination    
## Set per_page to 0 to disable pagination
per_page: 10    #每页显示的文章数，0表示不分页
pagination_dir: page

# Extensions    插件配置
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
plugins:
- hexo-generator-feed
theme: light    #使用的主题

feed:    #之后配置rss会用
  type: atom
  path: atom.xml
  limit: 20  

# Deployment    用于部署到github，之前已经配置过
## Docs: http://hexo.io/docs/deployment.html

deploy:
  type: git
  repo: ssh://git@github.com/git-xuhao/git-xuhao.github.io
  branch: master