一、准备工作

1. 安装Node.js

下载Node.js：官网下载地址（这里以Windows 为例）：
header

双击下载好的.msi文件，按下一步下一步，安装好就可以；

在cmd命令窗口，输入下面的这个命令，如果能够显示Node.js的版本，说明安装成功了。

node -v
header

2. 安装Git

下载Git：官网下载地址（这里以Windows 为例，我是在这里下载的） 你也可以到官网下载 ；

双击下载好的Git安装包，按下一步下一步，进行安装即可；

在cmd命令窗口，输入下面的这个命令，如果能够显示Git的版本，说明安装成功了。

git -version
header

想对Git有更多的了解，可以从下面几个网站学习，若你有更好的网站，也可以推荐给我：
官网
W3Cschool

二、Hexo搭建博客

1. 安装Hexo

在计算机中，新建一个winneyBlog文件夹，用于存放自己的博客内容。

在winneyBlog文件夹内，鼠标右键，选择Git Bash,进入到命令窗口

header
在命令窗口中，输入下面代码：
npm install -g hexo-cli

如图所示：
header

2. 初始化Hexo

在命令窗口中，输入下面代码：(会在winneyBlog目录下，新建了一个hexo文件夹)

hexo init hexo

如图所示：
header

3. 配置Hexo

进入hexo文件夹

cd hexo

安装依赖

npm install

部署形成的文件

hexo generate

如图所示：
header

4. 启动服务器

在命令窗口执行下面代码：

如图所示：（想要进行别的命令操作，可以按Ctrl + C停止服务器）
header

hexo server

在浏览器地址栏中输入http://localhost:4000/ （默认端口是4000），如果能够看到如图所示的效果，说明初始化的Hexo博客搭建成功了。
如图所示：
header

三、将本地的 Hexo 博客部署到 GitHub Pages上

1、新建一个仓库

仓库名为winney07.github.io（这个仓库的名称必须严格按照 username.github.io 的格式来命名）【前提是你要有一个Github账号】
如图所示：（因为我已经创建过这个库了，所以会显示红色警告，只是后来为了截图，重新写一个同名的）
header

2、进入已经创建好的仓库

（点击自己的头像，选择Your profile，点击刚创建好的那个仓库进去仓库里面），点击settings，找到GitHub Pages 选项，点击 Choose a theme 选择一个主题（可以选择也可以不选择，根据自己的需求决定是否操作这一步）
如图所示：
header

3、配置Git个人信息

在winneyBlog目录下，鼠标右键，选择Git Bash，进入命令窗口，输入下面的命令

1
2
git config --global user.name "Github用户名"       //自己Github的账号名
git config --global user.email "Github邮箱"        //自己注册Github的邮箱地址

4、生成SSH KEY

意思是生成一个公钥和密钥，因为Github需要一个密钥才能与本地相连接。在命令窗口输入下面的命令，然后需要连续按3次回车生成密钥（每按一次回车你可以看到对应的信息） 【你也可以先查看是否已经有了ssh密钥：cd ~/.ssh 如果没有密钥则不会有此文件夹，有则备份删除】

ssh-keygen -t rsa -C "Github邮箱" //自己注册Github的邮箱地址

如图所示：
header

5、生成的SSH KEY会保存

到 C:/Users/电脑名用户名/.ssh 目录中（根据你自己电脑用户名，打开对应的目录）
header

打开.ssh 这个目录，打开 id_rsa.pub 文件，复制里面的全部内容（这些内容就是密钥）
header

6、在GitHub中添加SSH keys

打开Github，点击头像，选择Settings；
header

选择SSH and GPG keys项,点击右上角New SSH key按钮，将刚刚复制到的密钥粘贴到key输入框中，title自己给它命一个名就好
header

最后点击Add Key，如果显示这样的界面，说明SSH KEY 配置成功：
header

7、修改全局配置文件

在hexo文件夹下，找到_config.yml文件；
如图所示：
header

复制仓库地址：
如图所示：
header

修改_config.yml文件里的deploy属性(目的是将本地hexo项目放到Github上)
如图所示：
header

注：【如果repository中填写的是https协议的，hexo d上传代码到Github时有下面类似错误，可以将repository改为ssh的链接】
如图所示：
header
header

8、安装hexo-deployer-git 插件

目的是将代码快速托管到Github上

npm install hexo-deployer-git --save

9、将hexo项目托管到GitHub上（命令可以分开写也可以一起写）

hexo clean && hexo generate && hexo deploy

备注：

1
2
3
hexo clean ：清除缓存文件 (db.json) 和已生成的静态文件 (public)
hexo generate ：部署之前预先生成静态文件，简写为hexo g
hexo deploy : 文件生成后立即部署网站，简写为hexo d

10、在浏览器地址栏输入 https://username.github.io/ 即可访问

（username也就是你的Github账户名），如果能够正常访问，并且跟本地hexo项目显示的内容是一样的，那么说明你已经把本地hexo项目部署到Github上了。

四、配置博客的个人信息

在hexo目录中，找到全局配置文件_config.yml

配置信息如下所示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site 站点信息配置
title: winney     #站点名
subtitle: It is never too old to learn.  #站点副标题
description: Doing is better than saying.     #站点信息简介
keywords: winneyBlog   博客
author: winney   #站点作者
language: zh-Hans     #站点语言，default默认是英文，zh-Hans是中文
timezone: Asia/Shanghai      #时区

# URL   博客地址
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: https://AAAAAAAAAA.github.io/
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: true
relative_link: false
future: true
highlight:
  enable: true
  line_number: true
  auto_detect: false
  tab_replace:
  
# Home page setting  主页设置
# path: Root path for your blogs index page. (default = '')
# per_page: Posts displayed per page. (0 = disable pagination)
# order_by: Posts order. (Order by date descending by default)
index_generator:
  path: ''
  per_page: 3  #每页文章数量
  order_by: -date
  
# 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
pagination_dir: page

# Extensions  扩展
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git    #部署的类型
  repository: https://github.com/AAAAAAA/AAAAAAA.github.io.git    #仓库地址
  branch: master    #分支名称
  message: hexo deploy  #提交信息

#Search
search:
  path: search.xml
  field: post
  format: html
  limit: 10000

注意：.yml 文件有严格的格式要求，文件里所有的配置都是：冒号 空格 值，并且冒号是英文状态下的输入。想了解更多的可以前往 官网 。

在博客目录下，右键点击Git Bash，进去命令窗口，输入下面的命令，即可在浏览器中看到刚刚设置的内容显示在页面中：

hexo server // 简写为 hexo s

提交到远程仓库报错
报403或者每次提交都要输入账号密码

可以将_config.yml里的

repository: https://github.com/*********.github.io.git #仓库地址

改为：

repository: [email protected]:*********.github.io.git #仓库地址