By

文章目录

小白花了两天时间搭建了自己的独立博客，进了很多坑，在这里分享一下，愿大家少走弯路。

特别鸣谢Code_Y,我也是跟着他的教程一点点学的。

1. 环境安装：

下载安装软件：

Node.js

我使用的版本是：

这里说明一下：
版本过低时，可能会报错，因此建议下载最新版本。

GitHub for Windows

安装好后，桌面会出现两个小图标

2. 测试SSH Key

在桌面或开始菜单找到Git Shell
如上图显示；

等待打开后输入一下命令

1
ssh -T git@github.com

如图：

如果出现问题，可以卸载GitHub for Windows 客户端，重新安装一遍

3. 注册Github

  1. 访问官网：https://www.github.com

ps:这里要注意一点，因为博客名称要与用户名一致，所以注册填写用户名的时候最好先想一下博客的名称；
例如，我的博客想用这个地址http://zhouxm0604.github.io/，那么申请的用户名就应该是zhouxm0604，只是个人经验，不一定对。

如图：

点击sign up或者直接在下侧填写，申请成功后验证邮箱并登录（点击sign in）。

4. 在github上创建仓储：

登录后-点击右上角new repository创建仓储，创建仓储名称填写yourname.github.io，
如图：

例如：仓储名称，我就写的是zhouxm0604.github.io

5. 使用Hexo创建博客框架

a. Hexo安装

打开Git Shell
启动后一次输入一下命令:

1
cd /
1
npm install hexo-cli -g 或 npm install -g hexo

提示：cd / 作用是返回根目录，Git Shell 默认装在 C盘，启动时默认路径为 C:\Users\xxx(用户名)\Documents\GitHub，输入 cd / 命令后就返回到了 C盘根目录下。

安装之后可以输入

1
hexo -v

检查一下是否安装成功

我装的是3.2.0的

b. Hexo部署

打开Git Shell

启动后输入一下命令

1
cd /
1
hexo init hexo

第一次报错

升级了node的版本后，再次进行部署，可以正常部署

使用命令，安装依赖文件（注意在hexo目录下安装）

1
npm install

经过以上两个方法的任意一种之后，Hexo 会自动在目标文件夹建立博客网站所需要的所有文件。
此时可以通过输入以下命令在本地进行预览：

1
hexo generate (可以简写成: hexo g)

如图：

1
hexo server

如图：

此时打开浏览器，在浏览器地址栏输入 http://localhost:4000/ （默认端口为4000）便可以看到最原始的博客了

如图：

6. 将本地文件部署到GitHub

修改 Hexo 中的 _config.yml 文件
用编辑器打开

找到其中的 deploy 标签，改成如图所示，并保存：

这里一定要注意格式：

冒号是半角英文，并且顶头空一格，冒号后面空一格，最后不空格

这边格式不对，也会各种报错。

其中 branch 选项可以填写 master 或 gh-pages。
如果你是为一个项目制作网站，那么需要把 branch 设置为 gh-pages 。若要绑定自定义域名也可以参考Hexo 或 Github Page 的帮助文档，制作一个 CNAME 文件。

hexo3.0以上版本需要单独安装Git

1
npm install hexo-deployer-git --save

将其deploy到仓储中

hexo clean
hexo generate（简写g）
hexo deploy （简写d）

如果此时依然报错

或者是其他错误

查看环境变量path中是否加入git

方法：cmd-path

如果没有添加，打开hexo中git的位置，复制，粘贴加入环境变量中去

再次执行命令：

hexo clean
hexo generate（简写g）
hexo deploy （简写d）

恭喜，到这一步，个人博客就已经部署到 GitHub 上了，此时通过 your_user_name.github.io（即你那个仓库的名称，形如：”你的 GitHub 用户名”.github.io） 就可以看到你的个人博客了。
使用 hexo new “文章名称” 可以进行新建文章

文章目录