本章教程适合windows10系列，win8及以下系统因为结构问题，安装npm后生成的hexo会经常报错，win10顺利切正常！！！

hexo介绍

hexo官方主页：官网

hexo官方文档中已经对hexo有了详细的介绍和说明，在这里我就不在继续阐述了.

• hexo是基于node.js制作的一个静态页面生成系统
• hexo生成的网站不需要我们部署到独立的服务器里面，不需要格外购买服务器，hexo生成的页面，我们可以上传到静态托管网站，比如国外的GitHub和国内的Gitee.
• hexo是使用Markdown语法发文章的，关于Markdown语法可以参考本站中的语法介绍.

目录

一、在本地建立Nodejs和Git环境.

二、安装hexo程序

三、生成网站并本地预览

四、注册Github账号并将hexo部署到Github上

一、本地建立Nodejs和Git环境

可以百度下载，也可以和我下载一样的版本，下载地址我放在文章末尾。安装程序很简单，一直下一步即可。

二、安装hexo程序

右击鼠标，点击Git Bash Here，此时会跳出来一个类似与cmd的黑框框，输入

npm install -g hexo-cli
不使用特殊工具，安装hexo时间可能较长

代码跑完后，再次输入hexo -v验证安装

hexo -v

如果安装程序正常，则会显示版本信息，如下：

hexo: 3.4.2
hexo-cli: 1.0.4
os: Windows_NT 6.1.7601 win32 x64
http_parser: 2.7.0
node: 8.9.1
v8: 6.1.534.47
uv: 1.15.0
zlib: 1.2.11
ares: 1.10.1-DEV
modules: 57
nghttp2: 1.25.0
openssl: 1.0.2m
icu: 59.1
unicode: 9.0
cldr: 31.0.1
tz: 2017b

如果正常显示，那就进入下一步

生成网站并本地预览.

随便找一个地方新建blog文件夹，右击打开Git Bash Here并输入：

hexo init
代码意思为在当前文件夹生成博客
npm install
安装所需要的组件
hexo g
生成本地静态页面
hexo s
在本地4000端口打开预览

如果生成顺利，则会显示链接地址，浏览器输入http://localhost:4000，即可进入预览网站.

四、注册Github账号并将网页托管到Github上

说明：Github是全球最大的代码开源共享网站，有静态页面托管功能，但是Github是国外网站，国内访问速度过慢，如果你有备案过的域名，可以使用国内的gitee（码云），功能和操作方式大同小异.

1.注册GitHub账号

• 点击此处进入Github官网
• 注册账号后点击Start aprojext，然后在项目框填写，请按照下方格式示例填写，否则会出现页面404

• 输入完成后点击Create repository选项提交

2.连接hexo与GitHub

• 博客文件夹右击打开Git Bash Here
• 输入以下命令生成ssh密匙，注意：如果重装系统或者更换电脑，需要重复此项操作！！！

ssh-keygen -t rsa -C “你注册GitHub的电子邮箱”

• 输入代码后你需要敲三次回车，最后可能询问你是否继续，输入yes回车，最终你会得到两份文件id_rsa和id_rsa.pub）
• 文件默认存储地址是C:Users你的系统账户.ssh 如果没有，则需要开启显示隐藏文件夹，不会的请百度.
• 将.ssh文件夹下的id_rsa.pub文件使用记事本打开，将里面的代码全部复制
• 点击GitHub主页面头像下的settings，点击 SSH and GPG keys ，点击 New SSH key，将id_rsa.pub文件里的内容复制上去后点击下面Add SSH Key以添加密匙。

3.存放博客的地方右击打开Git Bash，并执行：

git config —global user.name “Your Name”
git config —global user.email “email@example.com”

Your name为你注册GitHub的账户名称，email@example.com则为你注册时候的电子邮箱

完成之后，打开cmd或者PowerShell输入ssh -T git@github.com验证链接，如果成功，则会显示你的用户名，如下所示：

至此，你的电脑与GitHub已经建好连接

4.blog目录下_config.yml文件有关deploy的部分：

• 打开你博客存放的文件夹，根目录有一个_config.yml 文件，修改Deployment,写法如下：

deploy:
type: git
repository: git@github.com:yourname/username.github.io.git

- **yourname**为你的用户名**username**为你刚才创建的项目名
- 此时不能执行**hexo d**命令，否则会报错：

Deployer not found: github 或者 Deployer not found: git

- 原因是需要安装一个插件，命令如下：
```npm install hexo-deployer-git --save  ```
- 然后打开你的**Git bash**,输入**hexo d**即可将代码提交.
5.如果解析自己的域名，则每次提交之前都需要将自己的CNAME、README.md文件放在blog文件夹下的**public**内.
### 本文章结束，现在，你已经拥有了一个hexo博客，不信？访问注册时填写的后缀为github.io的网址吧！