Hexo 搭配 github 搭建博客系统及踩坑

Hexo 搭配 github 搭建博客系统

环境准备

Node 环境 (自带 npm 包管理器)
Git 环境

步骤、出现的问题及解决方案

1. node 环境 (自行去官网下载对应系统的版本，推荐v10.0以上版本)

2. git 也需要安装

   上面两个环境，安装时一般会默认配置 path 环境变量
   如果没有，就去查查自行配置吧，然后能够全局任意位置的 cmd 窗口都可以通过以下命令查看版本号

   node -v			// 查看 node 版本		或者 node --version
   git -v			// 查看 git 版本		或者 git --version
   

3. node 安装好，它会自带 npm 包管理器，但是由于用的是国外的镜像源，安装框架速度可能会很慢，所以可以选择安装一个 cnpm 包管理器代理 npm:

   npm i -g cnpm --registry=https://registry.npm.taobao.org
   

   后面的参数是设置下载镜像源为国内的 淘宝镜像源 (据说它是每十分钟刷新一次，让它自己与国外 npm 官网镜像资源保持一致)。

4. 然后全局安装 hexo-cli 脚手架

   cnpm i -g hexo-cli
   

   一般到这一步都没什么问题！

5. 创建一个新的空文件夹，我用 powershell / cmd / vscode 终端 三种方法以及管理员身份运行 powershell 运行构建 hexo 博客框架均无法正常成功。大致报错是，无法 clone xxx.git 什么的：

   hexo init	// 进到新文件夹后运行此命令
   // 或者, 未建立新文件夹时运行下面这条:
   hexo init blog	// 这里的 blog 为新创建的文件夹名 (你可以自行更改)
   

   到这一步，总是报错，让你 npm install 啥啥的，一旦弄了这个，文件夹又有东西了，又要清空文件夹；查了一些博客，也没看出个所以然来:

   • 有的让改 hosts 文件(我之前改过 github.com 网站 ip 配置)，按他的方法也还是没成功，更导致浏览器连 github.com 官网都打不开了(X)。
   • 有的博客让运行一个什么命令，但我一看那啥也不知道啥意思，不敢乱敲一些命令，到时候给我把系统搞崩了，我又得重装系统（麻烦…）(X)。
   • 还有一些其他啥的方法，反正没搞出来。
   • 然后，我 ping github.com 也一直超时丢包，反正就是 github官网 连不上的问题吧！
   • 我再用 git 命令试试能不能自己 clone 一个仓库下来验证一下能不能行？！好家伙，cmd 连我全局 git 都不认！！！无奈，用 git Bash 总能识别 git 吧！这就行了，在 git Bash 里运行 hexo init 就可以正常创建项目了。

   所以说，这个问题一般是命令终端没能适配的问题 (当然，我也不排除有其他的原因，反正我这里是这么个情况)。
   至于为什么试了多个终端 —— 因为有的不认识 cnpm 命令，有的不认识 git 命令，装好 hexo ，有的又不认识 hexo 命令(但环境变量都配了)，这个问题也没去深究，毕竟我这里的问题解决了。

6. 到这里，默认博客项目就已经搭建起来了。可能有的需要 npm install 再装一下依赖。

7. 执行 hexo s （hexo start 的缩写），本地就会搭建一个监听4000端口的默认静态资源博客系统了。

8. 另外需要更改配置，主题等，下载相应资源后更改 _config.yml 文件配置就可以了。

9. 将此博客推到 github 上托管，如我托管的简易博客 → suerssk.github.io

10. 前面创建 github 仓库必须是 你的用户名.github.io 仓库 (用户名是你登录 github 的用户名，例如：我的是 suerssk)，否则将无法托管上去，配置好 _config.yml 文件：

11. 通过以下命令 ：

    // 前面第 7 步之后装个工具 `hexo-deployer-git`  作为往 github 上推送代码的工具
    hexo clean  // 进行文件清理
    hexo g		// g 是 generator 的缩写，即生成需推送的文件
    hexo d		// d 是 deployer 的缩写，即将代码推送上去
    // 然后去浏览器地址栏输入 ——  你的用户名.github.io
    // 就可以看见你刚刚搭建的博客了