前言

  这是博主利用Hexo框架搭建好自己的博客网站后发表的第一篇博客。整个搭建过程不算太曲折,写这篇博客既是为了纪念自己搭建的过程,也是想为他人搭建博客提供一些帮助。

搭建过程

这是博主参考的文章:创作之路第一篇:配置环境并安装hexo_卸载hexo-CSDN博客

Node.js的安装及配置

  下载网址:Node.js 中文网

  2024最新版Node.js下载安装及环境配置教程【保姆级】_nodejs下载-CSDN博客

  博主参考了上面这篇文章来安装$Node.js$,前期跟着文章一步步来都没有问题,直到测试安装$express$模块的时候出现了问题。

1
npm install express -g  //安装express模块,-g代表全局安装

  运行上述命令时直接卡住了,显示$sill{\quad}idealTree{\quad}buildDeps$。博主在网上搜索该问题的解决方法,试了好多方法,最后将镜像源更换成新的淘宝镜像源,并且要保证网络连接正常,才解决了这一问题。

  参考文章:如何解决 npm install 卡在“sill idealTree buildDeps“的问题_npm sill idealtree builddeps-CSDN博客

1
2
npm config set registry https://registry.npmmirror.com //更换成新的淘宝镜像源
npm config get registry //检查镜像源是否更换成功

  之后再运行安装$express$模块的时候就能够正常安装了,出现了如下界面:

  随后按照文章步骤安装$cnpm$

1
cnpm -v

  执行上述命令查看安装是否成功时,显示”无法加载文件,因为禁止在此系统上运行脚本”

  博主在网上搜索该问题的解决方法,最后按照下面这篇文章里面的步骤成功查看了cnpm的版本信息。

  参考文章:cnpm : 无法加载文件 node_global\cnpm.ps1,因为在此系统上禁止运行脚本-CSDN博客

1
set-ExecutionPolicy RemoteSigned # 选择yes

  之后重新执行$cnpm{\quad}-v$命令即可显示:

  至此$Node.js$的安装配置就完成了!

Git的安装

  下载网址:Git - Downloads

  $Git$的安装相对简单,从官网下载安装即可,博主在这里就不再赘述了。

Hexo的安装及配置

  博主按照开始的那篇文章里面的步骤一步一步来最后成功安装了$Hexo$,这里附上命令$($以我自己的为例,在$Git$里面执行$)$

1
2
3
4
5
6
7
cd d:\
mkdir Hexo //新建一个文件夹

cd Hexo
npm install -g hexo-cli //安装Hexo

hexo init MDD_blog //MDD_blog是我自己起的名字,这步为初始化博客

  按照上述命令执行后得到如下界面即为成功(忽略博主截图里的那个$fatal$)

1
2
cd MDD_blog 
hexo s //在本地预览自己的博客

  出现下图即为成功$(Fluid$是博主自己保存的主题,新建的博客是默认主题$)$,将网址http://localhost:4000/粘贴到浏览器访问即可看到新搭建的博客。

  到这里就恭喜大家成功搭建自己的博客啦!当然这只是完成了一大半,后面还要关联博客到$Github$仓库,才能实现从网页访问自己的博客。

关联博客到Github仓库

  这一部分推荐大家看下面这篇文章,里面内容非常详细,博主也在按照步骤一步一步进行,但在配置$ssh$密钥时还是出现了问题。

  使用Hexo搭建个人博客,绑定GitHub以及个人域名_本地的hexo服务和github绑定起来-CSDN博客

  博主在配置$ssh$密钥的时候,要用如下命令验证配置是否成功

1
ssh -T git@github.com

  但是输入命令后卡住了,随后显示端口$22$无法连接。博主在网上查了很多,经过多次尝试,终于找到了解决方法。在$.ssh$文件夹中新建一个文本文档,命名为$config$,并去掉后缀名$.txt$,在该文件中添加如下内容

1
2
3
4
Host github.com
Hostname ssh.github.com
Port 443
User git

  之后再运行上述命令就可以成功连接了。随后按照文章接下来的步骤即可成功关联仓库,搭建如下的博客页面了!

写博客文章并上传

撰写博客文章

  相信大家在搭建好博客网页后都迫不及待的想要发表自己的第一篇文章,博主也是如此。博主用了$Typora$这一$Markdown$语言的编辑器来写文章,然而在插入图片的时候遇到了问题。博主插入本地图片后在本地可以显示,但是上传上去以后无法显示。为此,经过一番百度搜索,博主终于找到了解决方法,如下所示

1
2
3
4
5
6
//在博客文件夹的_config.yml文件修改
post_asset_folder: true
//这样在创建新的.md文件的同时也会创建对应的文件夹,之后将文章中的图片放到该文件夹中即可
//在博客文件夹下打开git bash,安装新插件,命令如下
npm install hexo-asset-img --save(如果npm无法连接或者报错的话,可以使用cnpm install hexo-asset-img --save安装)
//之后修改/node_modules/hexo-asset-image/index.js文件的第58行代码,改为下图所示的样子

1
2
3
插入图片名称如下:
![](./图片路径/图片名.图片后缀) // 路径使用相对路径,也就是复制图片路径后只保留当前.md文件对应文件夹及之后的路径
例如上面图片的路径为./我的第一篇博客/image-20250213181755868.png

  附文章链接关于hexo butterfly 文章内容图片加载不出来问题 | FeiFei

  博主将写好的$.md$文件存到博客文件夹里面$/source/_post$文件夹下面

上传博客

1
2
3
4
5
//在博客文件夹下打开命令行窗口,执行下列命令
hexo clean //清除静态文件
hexo g //重新生成静态文件
hexo d //部署到博客网页
hexo s //在本地查看博客网页,因为部署上去通过网页查看需要一定时间

  这样就更新了自己的博客,大家快去试试吧!

番外

  博主换新电脑后,需要将博客移动到新电脑上面,在移动过程中首先按照“$Node.js$的安装及配置”中的文章完成了$cnpm$的安装;下载配置$git$后,按照“关联博客到$Github$仓库”中的文章完成了$ssh$密钥的配置,原先的密钥不用删除,只要新建一个就行了;最后按照换电脑后怎样迁移Hexo博客 | 珍珠巧克力这一篇文章完成了博客的迁移,相较于搭建博客,整个过程非常简单!

结语

  以上就是博主搭建博客的全过程和遇到的问题,相较于身边的人,博主遇到的问题已经算很少了。搭建完一个博客心里也是成就感满满,博主希望大家都能顺顺利利地搭建好自己喜欢的博客网页!