坚持原创输出，点击蓝字关注我吧

作者：清菡

博客：Oschina、云+社区、知乎等各大平台都有。

目录

• 一、环境准备

• 安装 Node js

• 二、安装 Hexo 博客框架

• 三、使用 Hexo 搭建博客（本地启动）

• 四、部署到远端（Github）上公开使用

• 五、注意

Hexo 博客框架比较成熟，出了问题，网上可以搜索到很多的解决方式。无论是 Windows 还是 Linux，操作其实都是差不多的。我的是 Windows10 的电脑操作的。这个是我的个人博客地址：qinghan586.github.io

一、环境准备

提前装好 Git，这里不多讲解了，可以百度安装下。

安装 Nodejs

下载 nodejs：https://nodejs.org/en/

安装直接点击下一步、下一步就可以了。

安装完以后会有两个组件：1.是 npm 包管理器；2.是 Nodejs 本身。

如果是 mac，需打开终端切换到 root 用户:

sudo su

输入密码，敲回车。

输入clear清一下。

查看 node 的版本：node -v

查看 npm 包管理器的版本：npm -v

Windows 电脑我是直接以管理员身份打开 cmd，输入:

查看 node 的版本：node -v

查看 npm 包管理器的版本：npm -v

因为 Hexo 需要 Nodejs 支持的、生成的，所以这是前置步骤。

二、安装 Hexo 博客框架

需借助 npm 包管理器来安装。因为国内安装镜像源很慢，所以利用 npm 安装 cnpm。

用淘宝链接进行安装：

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

敲cnpm就可以自动补全了，这个工具说明就有了。

看下 cnpm 的版本：cnpm -v

这个是 mac 的截图，Windows 一样操作

安装 Hexo 框架：

cnpm install -g hexo-cli

hexo -v来验证下。

可以看到 Hexo 的博客框架是基于 node 的。

三、使用 Hexo 搭建博客（本地启动）

方式一：

在开始之前，输入 pwd 看下所处路径。

新建一个 blog 文件夹：mkdir blog

方式二：

我是直接在 E 盘自己手工创建了一个 blog 文件夹。

所有博客的东西全部都在 blog 里面生成。所以大家如果出了什么错，直接连 blog 文件夹整个删除就行了。注意：千万不能只删除 blog 文件夹里面的内容，却不删除 blog 文件夹，这样操作会出问题的。

进入 blog 的目录中，位于这个目录下，就可以使用 Hexo 生成我们的博客。

mac 下输入 sudo，表示用管理员的命令来执行，用 mac 电脑需要加上。

初始化一个博客：sudo hexo init

初始化一个博客：hexo init

您看，它会自己去克隆。还会默认克隆一个 Landscape 主题:

安装完成了！

看该目录下的所有子目录和文件：ls列出该目录下的所有子目录和文件的详细信息：ls -l

启动博客：hexo s

输入localhost:4000问下，看看博客是不是已经成功，已经有了，就像这样：

您看，还简介了 Hexo 怎么使用：

hexo s就是hexo server ，写一篇博客，可以用hexo s这个命令启动预览下。

hexo n "我的第一篇博客文章"

切换到 source，输入命令：cd source/_posts/

用 vim 编辑器：

可以进行编辑，也可以不编辑直接发布。

点击键盘的 i 进行编辑，shift 和 esc 同时按下(这里我记得是这样用的，如果不行可以百度下），然后输入:wq保存退出。这个不太好用，编辑用 Visual Studio Code 这个工具即可。

这样博客文章就创建好了。

输入 pwd，看到在 source 目录下，需要退 2 层回去：cd ../..

这样就到了 blog 目录。

接着输入以下命令：

清理下：hexo clean

生成下：hexo g

启动下：hexo s

刷新下：http://localhost:4000

以上 Hexo 博客的搭建已经完成了。

四、部署到远端（Github）上公开使用

1.登录自己的 Github。

2.新建一个仓库：

注意：一定是你的昵称.github.io

例如我的 Github 昵称是 qinghan586，那么这里输入qinghan586.github.io

现在是个空仓库，地址是这个，先放着。

继续在 blog 目录下，输入命令行操作：

装 Git 部署的插件：cnpm install --save hexo-deployer-git

里面的红色警告可以忽略不管。

去 blog 文件下，直接看到一个_config.yml，修改_config.yml即可。注意：blog文件夹下的其它文件下也有_config.yml文件，别改错了文件。

文件的最底部修改成这样：

deploy:  type: git  repository: https://github.com/qinghan586/qinghan586.github.io.git  branch: master

注意：deploy: type: repository: branch: 后面都有一个英文的空格。

用 nopad++修改后一定要保存！

部署到远端：hexo d

自动部署，需输入账号密码：

往远端推成功后，刷新 Github 仓库，发现多了很多东西，这些就是我的博客内容：

访问qinghan586.github.io就可以直接打开，并看到博客部署到 Github 上去了。

下载好看的主题：

好看的 Hexo 主题地址：https://hexo.io/themes/

自己来换个主题，克隆到 themes 主题下去：

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

git clone https://github.com/volantis-x/hexo-theme-volantis.git themes/volantis

themes 文件夹下就出现你下载的主题了。

现在把主题配置到博客上去：

修改_config.yml文件：

theme: yilia

theme: volantis

你用哪个主题就换哪个主题的名字，注意名称前面有个英文空格。

输入以下命令：

hexo clean

hexo g

hexo s

启动本地服务：http://localhost:4000看看，主题已经换了。

推到远端（github）上去：hexo d

推送完成！

访问qinghan586.github.io可看到主题成功换了！

以上整个过程已经完成了。

后续学下 css，然后才会把自己的博客修改的很漂亮。先搭建起来，再考虑博客内容美观的问题。

五、注意

修改_config.yml文件后，需要把主题配置到博客上去，输入

hexo clean

hexo g

hexo s

推到远端（github）上去：hexo d

都不行的情况下，可以换成这样的命令再次输入下：

npm install hexo-deployer-git --save

hexo clean

hexo generate

hexo deploy

出现提示 nothing to commit, working tree clean

我是这样提交文章成功的，依次输入：

git add .

git commit -m "one"

hexo clean

hexo generate

hexo deploy

hexo g

hexo d

hexo s

hexo s后就出来了，域名本地都可以访问了。

如果 Hexo 部署提交不上，Github 仓库上文件未更新。

删除 .deploy_git目录,再执行hexo d -g就可以了。

Github 比较慢，刷新后要耐心等待下。

开启无痕模式加载网页，ctrl+shift+delete清除缓存有时候不一定管用（原因不明）。

较为靠谱的参考链接:https://segmentfault.com/q/1010000003481894?utm_source=sf-similar-question

公众号 「清菡软件测试」 首发，更多原创文章：清菡软件测试 95+原创文章，欢迎关注、交流，禁止第三方擅自转载。