【新手/零基础】Hexo+Gitee个人博客搭建教程--详细版

前言

点此转到--精简版

可能很多小伙伴都有搭建一个属于自己的博客的想法。但是经常是无奈于自己匮乏的知识。但是，每个老手都是新手过来的，再困难的事情，只要肯花一点时间都可以办成。

本次教程分为详细版和精简版。

精简版，顾名思义，废话少说，重在操作。

详细版，重在拓展基础知识，并且通俗易懂的讲解。大家可以按需取用。

另外，文章末尾常见问题部分写了几个新手经常忽略的点 & 遇到的坑

建议大家在遇到问题的时候，先ctrl+F在此页面先搜索，找不到再百度或谷歌。

前期准备

搭建前需要知道的

一个网站的搭建，主要分为三个主要部分
- 域名
- 服务器
- 配置

域名是什么？

我们大家耳熟能详的www.baidu.com就是一个域名，比如当你想去朋友家玩的时候，首先要知道朋友家在哪，就是我们常说的ip地址，可以把它理解为一个门牌号。比如百度的ip地址220.181.38.150，我们可以直接在浏览器中输入这串数字访问百度。但是有小伙伴该说了，这么长谁记得住。确实，由于IP地址具有不方便记忆并且不能显示地址组织的名称和性质等缺点，人们设计出了域名，并通过网域名称系统(DNS)来将域名和IP地址相互映射，使人更方便地访问互联网，而不用去记住能够被机器直接读取的IP地址数串。所以如果你也想有自己的博客/网站，也需要有自己的域名。

服务器是什么？云服务器呢？

域名和云服务器都可以购买。

Git是什么？gitee呢？

讲完前面两个东西，又有小伙伴问了，我就是练练手，不想买呢。

那么这篇教程就很适合你了，Github和Gitee为了方便用户展示自己仓库的项目，都提供了Git(ee) Pages服务，这是什么东西呢？它们是一个免费的静态网页托管服务。简单来说，就是项目作者用来展示项目内容或者发布帮助文档的地方。当开启这个服务后，gitee会自动分配一个https://www.你的用户名.gitee.io/你的仓库名这样一个域名。

白嫖党福利？

这就有意思了，前面我们提到，一个网站的搭建主要就有域名``服务器``配置这三个方面，前两个人家不都已经提供给我们了嘛，对于我们这种小白，抱着试一试的想法去搞个人博客/网站，是不是很香？又是白嫖党的福利。

域名和服务器

常用windows系统的小伙伴可能不经常使用命令行，所以可以了解一点关于命令行和终端相关基本操作

（http：//），有精力和兴趣的可以直接学Linux，它是大势所趋
git bush/cmd等命令行操作，如果没有在环境变量里设为全局变量，哪个包（或者应用）的操作就要到它对应的目录下运行命令行语句！而且要注意区分目录层级。
一定要善于查看和使用对应的技术手册or文档，这是开源作者or团队成员的高度精华。你现在存在问题，可能他们已经有解决方案了。

举个例子：在使用不同的Hexo主题时，一定要查阅主题作业自己的文档，他们在做自己的主题的时候，是会修改甚至覆盖Hexo官方的一些配置项目的。本人的主题就是这样，配置文件也转变成了melodyxxxx。
换源很重要！

由于大部分源代码都在GitHub上下载的，而国内访问会超时导致无法下载。要事先换成镜像源。这对经常接触各类项目的人来说很常见。

搭建步骤

3和1顺序调换！

安装git

git是什么？

git的配置

安装node.js

码云Gitee

注册

（Gitee是中国版的github，用它而不是用github的原因显而易见，国内访问国内服务器当然比较快了。感兴趣的可以按照这篇文章的步骤搭建基于Github Page的个人博客）

新建仓库

SSH公钥

部署Gitee Page

下载hexo

hexo init

运维

缝缝补补+发布新文章

如果在缝缝补补（换主题/添加了第三方插件）的过程中又出现问题，ctrl+f。

以后发布文章就可以

(可选)hexo clean --删掉本地public目录，清除本地缓存

hexo g --收集生成相应文件

(可选)hexo s --打开服务，可以在localhost:4000预览

hexo d --部署/git push到远端仓库

写文章/博客

首先推荐的就是在CSDN里面写，有很多快捷方式，并且一些LaTex、UML图都有，写完再导出markdown文件。（需要注意的是你的hexo项目里的makedown是否可以解析，这一点可以百度）

或者在VS Code这类编辑器里写，也很方便。它们都有实时预览，保证解析出来的效果。

Markdown教程--菜鸟教程

常见问题FAQ

搭建过程中的问题

一个在我搭建的过程中困扰我很久的问题：明明hexo s运行后，在localhost:4000里看的很正常，但是hexo d部署后gitee.io网页没有更新，甚至有时候排版错乱。这种情况下可以尝试下面几个步骤：
试一下hexo clean，再hexo g

这个是由于xxxxxxxxxx
清除浏览器缓存

其实别人查看的时候是没有问题的。浏览器为了加快访问速度，因为你之前多次打开，都会有缓存，导致更新没有真正完成，不同的浏览器可以百度看怎么清缓存
在git page服务中，更新部署这个是前面两步都没有效果的时候，试试这个可能有奇效。

参考资料

1.Hexo+Gitee 搭建独立博客

2.基于Gitee+Hexo搭建个人博客

3.Hexo官方中文文档

4.melody主题使用文档

5.MARKSZのBlog--主题作者博客demo