前言

最近想搭建一个博客，一开始本来想用老牌的WordPress，但是想了一下以前搭建这玩意儿的时候是要用到数据库的，这样就得要自己搞个服务器和域名。看了一下现在的云服务都是几大百，作为一个老白嫖党，就去搜了一下有没有免费的，结果果然就让我搜到了。

就是这个HEXO框架，是现在比较流行的静态博客生成框架。加上Gitee可以免费申请pages服务，所以就可以基于此搭建一个有域名的静态博客了。

先说一下博客网站的基本结构，HEXO是生成博客样式的框架，基于Node.js，所以需要安装nodejs环境。然后Gitee是国内的开源git平台，优势主要是比GitHub网速快，同样需要安装git环境。

一、安装Git

廖雪峰大佬的Git教程，从入门到入土应该够了。https://www.liaoxuefeng.com/wiki/896043488029600

二、安装Nodejs

Nodejs下载，一个JavaScript运行环境。博客项目hexo就是基于它才能运行。

https://www.liaoxuefeng.com/wiki/896043488029600

三、安装hexo&创建&发布

hexo官方文档，安装hexo脚手架

npm install -g hexo-cli

创建你的本地项目，随便找一个路径，如E盘的hexoblog文件夹

hexo init E:/hexoblog
cd hexoblog
npm install

项目创建成功后，新建第一个博客，你好世界。

hexo new post hello-world

编译项目

hexo generate

启动项目，默认本地浏览器localhost:4000访问

hexo server

默认的样式长这样

将项目上传到Gitee仓库，注意本地的那些yaml配置是不会传到git上的，git上只有用于部署访问的静态文件。

hexo deploy

四、使用Gitee的Pages功能部署

使用Gitee Pages功能部署项目，注意这个功能需要Gitee实名认证，可能要等个一两天

然后就可以访问了

五、使用主题

hexo可以使用各种样式炫酷的主题，在官方网站可以看到

https://hexo.io/themes/

我使用的是Butterfly主题，可以去这个网站参考如何配置

https://butterfly.js.org/posts/21cfbf15/

六、怎么传图片

第一种：使用图片链接直接链接到文章中，最简单，推荐如果不想被坑就用这个。只是如果原链接失效了，图就挂了。

第二种：使用图床，本质和第一种一样，只是图床的图是你自己手工上传的，然后也用链接引进来，图床服务器要收费，免费的一般限时限量。而且如果万一服务商跑路了，图还是挂了。

第三种：直接把图片放在本地的项目里，随着发布提交到git仓库，然后部署到服务器访问。理论上除非Gitee凉了，不然图肯定在（就算凉了你本地还有一份副本）

修改之后能正常渲染图片的路径了：

这里主要说说第三种遇到的史前巨坑，hexo的本地图片插件有bug，无法同时做到本地Typora查看和部署后正常展示。其原因是因为插件没有正确识别后去重图片路径，导致路径始终重复。最后我改了插件的代码才解决了。

插件名字：

要手动改的代码如下：

结语

写完这个攻略，我发现漏了很多，比如Git本地生成秘钥配置到Gitee才能访问远程git仓库，比如怎么使用Typora编写博客的md文件，hexo的一些基本配置和怎么安装主题等等……

其实网上也有很多类似的教程，搜Hexo+Gitee搭建个人博客就能找到了。

所以如果对于Git、JavaScript、Markdown都不太了解也没兴趣的朋友，我还是建议考虑b站、简书、语雀之类的吧，简单好用。

总之是一次兴趣使然的瞎折腾，以后咱尽量能带来一些更有趣的内容。

感谢阅读。

个人博客链接：

http://com-jysg-never-end.gitee.io/blog/2022/07/07/02-how-to-create-free-blog