# 1. 准备

输入代码时，核对准确，最好切换成英文输入法；
将文中的 “用户名” 和 “邮箱” 替换为自己的 GitHub 账户名和绑定的邮箱；
统一使用 Git Bash 进行操作（支持 Win、Mac）;
小白请严格按步骤进行，不要跳！

# 环境搭建

Hexo 基于 Node.js，搭建过程中还需要使用 npm（Node.js 已带）和 git，因此先搭建本地操作环境，安装 Node.js 和 Git。

Node.js：https://nodejs.org/zh-cn
Git：https://git-scm.com/downloads
下载 Node.js 和 Git 程序并安装，一路点 “下一步” 按默认配置完成安装。

安装完成后，Win+R 输入 cmd 并打开，依次输入 node -v、npm -v 和 git --version 并回车，如下图出现程序版本号即可。

# 2. 连接 Github

使用邮箱注册 GitHub 账户，选择免费账户（Free），并完成邮件验证。

右键 -> Git Bash Here，设置用户名和邮箱：

git config --global user.name “GitHub 用户名”
git config --global user.email “GitHub 邮箱”
创建 SSH 密匙：

输入 ssh-keygen -t rsa -C “GitHub 邮箱”，然后一路回车。

添加密匙：

进入 [C:\Users\ 用户名.ssh] 目录（要勾选显示 “隐藏的项目”），用记事本打开公钥 id_rsa.pub 文件并复制里面的内容。

登陆 GitHub ，进入 Settings 页面，选择左边栏的 SSH and GPG keys，点击 New SSH key。

Title 随便取个名字，粘贴复制的 id_rsa.pub 内容到 Key 中，点击 Add SSH key 完成添加。

验证连接：

打开 Git Bash，输入 ssh -T git@github.com 出现 “Are you sure……”，输入 yes 回车确认。

显示 “Hi xxx! You’ve successfully……” 即连接成功。

# 3. 创建 Github Pages 仓库

GitHub 主页右上角加号 -> New repository：

Repository name 中输入用户名.github.io
勾选 “Initialize this repository with a README”
Description 选填
填好后点击 Create repository 创建。

创建后默认自动启用 HTTPS，博客地址为：https:// 用户名.github.io

# 4. 本地安装 Hexo 博客程序

新建一个文件夹用来存放 Hexo 的程序文件，如 Hexo-Blog。打开该文件夹，右键 -> Git Bash Here。

# 安装 Hexo

使用 npm 一键安装 Hexo 博客程序：

npm install -g hexo-cli
Mac 用户需要管理员权限（sudo），运行这条命令：

sudo npm install -g hexo-cli
安装时间有点久（真的很慢！），界面也没任何反应，耐心等待，安装完成后如下图。

# Hexo 初始化和本地预览

初始化并安装所需组件：

注意记得安装主题插件

安装 shoka 需要的组件

npm i hexo-renderer-multi-markdown-it --save
npm install hexo-autoprefixer --save

hexo init # 初始化
npm install # 安装组件
完成后依次输入下面命令，启动本地服务器进行预览：

hexo g # 生成页面
hexo s # 启动预览
访问 http://localhost:4000，出现 Hexo 默认页面，本地博客安装成功！

Tips：如果出现页面加载不出来，可能是端口被占用了。Ctrl+C 关闭服务器，运行 hexo server -p 5000 更改端口号后重试。

Hexo 博客文件夹目录结构如下：

# 部署 Hexo 到 GitHub Pages

本地博客测试成功后，就是上传到 GitHub 进行部署，使其能够在网络上访问。

首先安装 hexo-deployer-git：

npm install hexo-deployer-git --save
然后修改 _config.yml 文件末尾的 Deployment 部分，修改成如下：

deploy:
type: git
repository: git@github.com: 用户名 / 用户名.github.io.git
branch: master
完成后运行 hexo d 将网站上传部署到 GitHub Pages。

完成！这时访问我们的 GitHub 域名 https:// 用户名.github.io 就可以看到 Hexo 网站了。