最新最全!github+hexo:搭建个人博客的常见错误及解决!
最近看到一个学长的blog感觉好好看哈哈哈哈心痒痒就像也做一个自己的blog玩玩!有遇到一个卡了好几天的问题,在此记录。
建议!!!
搭配以下文章食用!这篇很详细捏,但是我遇到一些错误所以记录一些解决方法~非常非常详细了!
GitHub Pages + Hexo搭建个人博客网站,史上最全教程_hexo博客-CSDN博客
一、准备工作
包括下载注册github和git(其实这一步我当年搞了一个下午hhh,但是忘了怎么做了所以不详细说了)、下载node.js(网站必备啦)
二、创建仓库
(dbq啊啊啊摆烂了这一步跟着做就行)
三、安装hexo
在确保安装好nodejs之后,这里可以“管理员身份运行”visual studio,在终端输入;也可以在pwershell管理员身份运行输入。
npm install -g hexo-cli
四、更换主题
我用的是fluid主题。
(以下节选自官网!我用的就是方法一)
方式一
Hexo 5.0.0 版本以上,推荐通过 npm 直接安装,进入博客目录执行命令(记得开管理员权限哈):
npm install --save hexo-theme-fluid
然后在博客目录下创建 _config.fluid.yml,将主题的 _config.yml (opens new window)内容复制过去。
之后在“node_modules/hexo-theme-fluid”可以找到下载的主题!(后面有用!哦但是不能改这个会被覆盖!!!)
五、创建文章(有坑!)
这一步是我要重点记录的步骤!!!搭配以下文章食用!!!
重点注意:
1、“在你的hexo目录下执行npm install hexo-asset-image --save,这是下载安装一个可以上传本地图片的插件”
2、一定要改index.js(截图佬的文章!!salute!!!!)


六、个性化设置
比如改博客标题:
刚刚我们提到的目录 node_modules/hexo-theme-fluid下 _config.yml 中的 blog_title 字段。

其他就不截图啦!
------------------------------------二编 2025/8/6-------------------------------------
nonono。
因为我们是用npm下载fluid主题的,所以应该在根目录的_config.fluid.yml修改配置。这是我犯的一个大错,试了很久都个性化不了。
正确方法:
首先确保根目录的_config.fluid.yml初始内容是复制的node_modules/hexo-theme-fluid下 _config.yml文件!
然后【所有的个性化操作都只修改根目录的_config.fluid.yml文件!!!!这个是优先级最高的,不会被覆盖。】
比如改这里呀~等等

六、启用数据统计和评论功能
按照教程我试了很久,但是没有反应......【心碎碎
Hexo-fluid主题设置统计博客阅读量与评论 - 贾明晖的博客
--------------------------------二编 2025/8/9--------------------------------------------------------------
可以啦!
除了按照教程把一些false改为true等等的操作(细心即可),还需要注意我是国内版,(国际版不需要填写server_url)所以除了app_key和app_id,还必须填写server_url!!!!!非常重要!!!!

在哪里找呢?
左侧菜单 → 设置 → 应用凭证。在 "域名" 部分找到 REST API 服务器地址,填写即可。

显示成功!!!!开心开心

七、发布网页
找tokens+修改deploy之后出现这样的报错.......

超详细Hexo+Github Pages搭建个人博客教程_github pages搭建博客-CSDN博客
请参考以上教程!啊啊啊重点是需要管理员权限操作+开梯子(才能拉仓库)!不然就报错嗷嗷嗷嗷
输入:
hexo clean
hexo g
hexo deploy
成功!

可以再检查下github--actions显示的状态,都是绿色说明部署成功!!!!

啊啊啊啊啊啊啊啊啊啊啊啊啊啊成功了!!!!需要等待一会!!!我说咋还是进不去啊啊啊啊啊

八、一些其他的优化.....(正在尝试版)
1、一个交互式的看板娘
我的自定义多交互live2d折腾经历 - c10udlnk - 博客园
Hexo(sakura)添加live2d看板动画(可对话,换装互动)_hexo matery live2d 换装-CSDN博客
普通版的live2d非常简单:(19 封私信 / 80 条消息) 给hexo博客添加Live2d小人 - 知乎
如果想要有文字的那种就需要使用大神版live2d了TT,参考以上吧。stevenjoezhang/live2d-widget: 把萌萌哒的看板娘抱回家 (ノ≧∇≦)ノ | Live2D widget for web platform
2、自定义js和css
在此目录下根目录/source新建js, css文件夹。
然后可以使用这位老师写好的js和css文件!非常有用!Hexo + Fluid 美化 | EmoryHuang's Blog

最终修改_config.fluid.yml文件。我的引用就是这样滴~

欢迎大家访问我的blog!!!
更多推荐
所有评论(0)